sp_helppublication (Transact-SQL)
Devuelve información acerca de una publicación. Este procedimiento almacenado se ejecuta en el publicador de la base de datos de publicación, para una publicación de MicrosoftSQL Server. En el caso de una publicación Oracle, se ejecuta en el distribuidor de cualquier base de datos.
Sintaxis
sp_helppublication [ [ @publication = ] 'publication' ]
[ , [ @found=] found OUTPUT]
[ , [ @publisher = ] 'publisher' ]
Argumentos
[ @publication = ] 'publication'
Es el nombre de la publicación que se va a ver. publication es de tipo sysname y su valor predeterminado es %, que devuelve información acerca de todas las publicaciones.[ @found = ] 'found' OUTPUT
Es un indicador que especifica que se devuelven filas. foundes de tipo int, es un parámetro de salida (OUTPUT) y su valor predeterminado es 23456. 1 indica que la publicación se ha encontrado. 0 indica que la publicación no se ha encontrado.[ @publisher = ] 'publisher'
Especifica un publicador que no es de SQL Server. publisher es de tipo sysname y su valor predeterminado es NULL.[!NOTA]
No debe especificarse publisher al solicitar información de publicación de un publicador SQL Server.
Conjuntos de resultados
Nombre de columna |
Tipo de datos |
Descripción |
---|---|---|
pubid |
int |
Id. de la publicación. |
name |
sysname |
Nombre de la publicación. |
restricted |
int |
Solo se identifica con fines informativos. No compatible. La compatibilidad con versiones posteriores no está garantizada. |
status |
tinyint |
Estado actual de la publicación. 0 = Inactivo. 1 = Activo. |
task |
|
Se utiliza para mantener la compatibilidad con versiones anteriores. |
replication frequency |
tinyint |
Tipo de frecuencia de replicación: 0 = Transaccional 1 = Instantánea |
synchronization method |
tinyint |
Modo de sincronización: 0 = Programa nativo de copia masiva (herramienta bcp). 1 = Copia masiva de caracteres. 3 = Simultánea, que significa que se utiliza la copia masiva en modo nativo (herramienta bcp) pero no se bloquean las tablas durante la instantánea. 4 = Concurrent_c, que significa que se utiliza la copia masiva en modo de caracteres pero no se bloquean las tablas durante la instantánea. |
description |
nvarchar(255) |
Descripción opcional de la publicación. |
immediate_sync |
bit |
Indica si los archivos de sincronización se crean, o se vuelven a crear, cada vez que se ejecuta el Agente de instantáneas. |
enabled_for_internet |
bit |
Indica si los archivos de sincronización de la publicación se exponen en Internet a través del protocolo de transferencias de archivos (FTP) u otros servicios. |
allow_push |
bit |
Indica si se admiten suscripciones de inserción a la publicación. |
allow_pull |
bit |
Indica si se admiten suscripciones de extracción a la publicación. |
allow_anonymous |
bit |
Indica si se admiten suscripciones anónimas a la publicación. |
independent_agent |
bit |
Indica si hay un Agente de distribución independiente para esta publicación. |
immediate_sync_ready |
bit |
Indica si el Agente de instantáneas generó o no una instantánea que está lista para que la utilicen las nuevas suscripciones. Este parámetro se define únicamente si la publicación se define para tener siempre una instantánea disponible para las suscripciones nuevas o reinicializadas. |
allow_sync_tran |
bit |
Indica si se permiten suscripciones de actualización inmediata a la publicación. |
autogen_sync_procs |
bit |
Indica si se generan automáticamente procedimientos almacenados para admitir las suscripciones de actualización inmediata. |
snapshot_jobid |
binary(16) |
Id. de tarea programada. |
retention |
int |
Volumen de cambio, en horas, que se debe guardar para la publicación indicada. |
has subscription |
bit |
Indica si la publicación tiene suscripciones activas. 1 significa que tiene suscripciones activas y 0 significa que no tiene ninguna suscripción. |
allow_queued_tran |
bit |
Especifica si se han habilitado las deshabilitaciones de colocación en cola de los cambios del suscriptor hasta que se puedan aplicar en el publicador. Si es 0, los cambios no se ponen en cola en el suscriptor. |
snapshot_in_defaultfolder |
bit |
Especifica si los archivos de instantánea se almacenan en la carpeta predeterminada. Si es 0, los archivos de instantánea se almacenan en la ubicación alternativa especificada en alternate_snapshot_folder. Si es 1, los archivos de instantáneas se encuentran en la carpeta predeterminada. |
alt_snapshot_folder |
nvarchar(255) |
Especifica la ubicación de la carpeta alternativa de la instantánea. |
pre_snapshot_script |
nvarchar(255) |
Especifica un puntero a una ubicación de archivo .sql. El Agente de distribución ejecutará el script previo a la instantánea antes de la ejecución de cualquiera de los scripts de los objetos replicados al aplicar la instantánea en un suscriptor. |
post_snapshot_script |
nvarchar(255) |
Especifica un puntero a una ubicación de archivo .sql. El Agente de distribución ejecutará el script posterior a la instantánea después de que se apliquen el resto de scripts de objetos replicados y datos durante la sincronización inicial. |
compress_snapshot |
bit |
Especifica que la instantánea que se ha escrito en la ubicación alt_snapshot_folder está comprimida en el formato CAB de Microsoft. 0 especifica que no se comprimirá la instantánea. |
ftp_address |
sysname |
Dirección de red del servicio FTP para el distribuidor. Especifica dónde se encuentran los archivos de instantánea de una publicación para que los recoja el Agente de distribución o el Agente de mezcla de un suscriptor. |
ftp_port |
int |
Número de puerto del servicio FTP para el distribuidor. |
ftp_subdirectory |
nvarchar(255) |
Especifica dónde estarán disponibles los archivos de instantánea para que los recoja el Agente de distribución o el Agente de mezcla del suscriptor si la publicación admite la propagación de instantáneas mediante FTP. |
ftp_login |
sysname |
Nombre de usuario que se utiliza para conectar con el servicio FTP. |
allow_dts |
bit |
Especifica que la publicación permite transformaciones de datos. 0 especifica que no se permiten transformaciones DTS. |
allow_subscription_copy |
bit |
Especifica si se ha habilitado la capacidad de copiar las bases de datos de suscripciones que se suscriben a esta publicación. 0 significa que no se permite la copia. |
centralized_conflicts |
bit |
Especifica si los registros de conflicto se almacenan en el publicador. 0 = Los registros de conflicto se almacenan tanto en el publicador como en el suscriptor que creó el conflicto. 1 = Los registros de conflicto se almacenan en el publicador. |
conflict_retention |
int |
Especifica el período de retención de conflictos, en días. |
conflict_policy |
int |
Especifica la directiva de resolución de conflictos seguida cuando se utiliza la opción de suscriptor de actualización en cola. Puede ser uno de los valores siguientes: 1 = El publicador gana el conflicto. 2 = El suscriptor gana el conflicto. 3 = Se reinicializa la suscripción. |
queue_type |
|
Especifica el tipo de cola utilizado. Puede ser uno de los valores siguientes: msmq = Utiliza Microsoft Message Queue Server para almacenar las transacciones. sql = Utiliza SQL Server para almacenar las transacciones.
Nota
Ya no se incluye la compatibilidad con Message Queue Server.
|
backward_comp_level |
|
Nivel de compatibilidad de la base de datos, que puede ser uno de los valores siguientes: 10 = MicrosoftSQL Server 7.0 20 = Service Pack 1 de SQL Server 7.0 30 = Service Pack 2 de SQL Server 7.0 35 = Service Pack 3 de SQL Server 7.0 40 = MicrosoftSQL Server 2000 50 = Service Pack 1 de SQL Server 2000 60 = Service Pack 3 de SQL Server 2000 90 = MicrosoftSQL Server 2005 100 = MicrosoftSQL Server 2008 |
publish_to_AD |
bit |
Especifica si la información de publicación se publica en Microsoft Active Directory™. Un valor de 1 indica que se publica; 0 indica que no se publica. |
allow_initialize_from_backup |
bit |
Indica si los suscriptores pueden inicializar una suscripción a esta publicación a partir de una copia de seguridad en lugar de una instantánea inicial. 1 significa que las suscripciones pueden inicializarse a partir de una copia de seguridad; 0 significa que no. Para obtener más información, vea Inicializar una suscripción transaccional sin una instantánea. |
replicate_ddl |
int |
Indica si se admite la replicación de esquemas para la publicación. 1 indica que las instrucciones de lenguaje de definición de datos (DDL) ejecutadas en el publicador se replican; 0 indica que no se replican. Para obtener más información, vea Realizar cambios de esquema en las bases de datos de publicación. |
enabled_for_p2p |
int |
Indica si la publicación se puede utilizar en una topología de replicación de punto a punto. 1 indica que la publicación admite la replicación de punto a punto. Para obtener más información, vea Replicación transaccional del mismo nivel. |
publish_local_changes_only |
int |
Solo se identifica con fines informativos. No compatible. La compatibilidad con versiones posteriores no está garantizada. |
enabled_for_het_sub |
int |
Especifica si la publicación admite suscriptores que no son SQL Server. Un valor de 1 significa que se admiten los suscriptores que no son SQL Server. Un valor de 0 significa que sólo se admiten los suscriptores que son SQL Server. Para obtener más información, vea Suscriptores que no son de SQL Server. |
enabled_for_p2p_conflictdetection |
int |
Especifica si el Agente de distribución detecta los conflictos para una publicación que está habilitada para la replicación del mismo nivel. Un valor de 1 significa que se detectan los conflictos. Para obtener más información, vea Detección de conflictos en la replicación punto a punto. |
originator_id |
int |
Especifica un Id. para un nodo en una topología del mismo nivel. Este Id. se utiliza para la detección de conflictos si enabled_for_p2p_conflictdetection está establecido en 1. Para obtener una lista de identificadores que ya se hayan utilizado, consulte la tabla del sistema Mspeer_originatorid_history. |
p2p_continue_onconflict |
int |
Especifica si el Agente de distribución continúa procesando los cambios cuando se detecta un conflicto. El valor 1 significa que el agente continúa procesando los cambios.
Advertencia
Se recomienda utilizar el valor predeterminado 0. Cuando esta opción está establecida en 1, el Agente de distribución intenta converger los datos en la topología aplicando la fila en conflicto del nodo que tiene el identificador de originador más alto. Este método no garantiza la convergencia. Debe asegurarse de que la topología sea coherente una vez detectado un conflicto. Para obtener más información, vea "Controlar los conflictos" en Detección de conflictos en la replicación punto a punto.
|
alllow_partition_switch |
int |
Especifica si las instrucciones ALTER TABLE...SWITCH se pueden ejecutar con la base de datos publicada. Para obtener más información, vea Replicar tablas e índices con particiones. |
replicate_partition_switch |
int |
Especifica si las instrucciones ALTER TABLE...SWITCH que se ejecutan con la base de datos publicada se deben replicar en los suscriptores. Esta opción sólo es válida si allow_partition_switch se establece en 1. |
Valores de código de retorno
0 (correcto) o 1 (error)
Notas
El procedimiento sp_helppublication se utiliza en la replicación de instantáneas y transaccional.
sp_helppublication devolverá información sobre todas las publicaciones que son propiedad del usuario que ejecuta este procedimiento.
Ejemplo
DECLARE @myTranPub AS sysname
SET @myTranPub = N'AdvWorksProductTran'
USE [AdventureWorks]
EXEC sp_helppublication @publication = @myTranPub
GO
Permisos
Sólo los miembros de la función fija de servidor sysadmin en el publicador, miembros de la función fija de base de datos db_owner en la base de datos de publicación o usuarios de la lista de acceso a la publicación (PAL) pueden ejecutar sp_helppublication.
En el caso de un publicador que no es de SQL Server, únicamente los miembros de la función fija de servidor sysadmin en el distribuidor, miembros de la función de base de datos fija db_owner en la base de datos de distribución o usuarios de PAL pueden ejecutar sp_helppublication.