sp_helppublication (Transact-SQL)

Artículo
03/07/2014

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 Microsoft SQL Server. En el caso de una publicación Oracle, se ejecuta en el distribuidor de cualquier base de datos.

Icono de vínculo a temas Convenciones de sintaxis de Transact-SQL

Sintaxis

sp_helppublication [ [ @publication = ] 'publication' ]
    [ , [ @found=] found OUTPUT]
    [ , [ @publisher = ] 'publisher' ]

Argumentos

[ @publication = ] 'publication'
Es el nombre de la publicación que se va a consultar. publication es de tipo sysname, con un valor predeterminado de %, que devuelve información sobre todas las publicaciones.
[ @found = ] 'found' OUTPUT
Is una marca que indica las filas devueltas. foundes de tipo int y un parámetro OUTPUT, con un valor predeterminado de 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	Solamente 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 (utilidad bcp). 1 = Copia masiva de caracteres. 3 = Simultánea, que indica que se utiliza la copia masiva en modo nativo (utilidad 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 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 que se especifican a continuación: 90 = Microsoft SQL Server 2005 100 = Microsoft SQL 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, mientras que 0 indica que las instrucciones de DDL no se replican. Para obtener más información, vea Realizar cambios de esquema en bases de datos de publicaciones.
enabled_for_p2p	int	Indica si la publicación se puede utilizar en una topología de replicación punto a punto. 1 indica que la publicación admite la replicación punto a punto. Para obtener más información, vea Replicación transaccional punto a punto.
publish_local_changes_only	int	Solamente 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 solo 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 punto a punto. 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 punto a punto. 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 solo es válida si allow_partition_switch se establece en 1.

Valores de código de retorno

0 (correcto) o 1 (error)

Comentarios

Se usa sp_helppublication 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 [AdventureWorks2012]
EXEC sp_helppublication @publication = @myTranPub
GO

Permisos

Solo los miembros del rol fijo de servidor sysadmin en el publicador o los miembros del rol fijo de base de datos db_owner en la base de datos de publicación o los 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 del rol fijo de servidor sysadmin en el distribuidor, los miembros del rol fijo de base de datos db_owner en la base de datos de distribución o los usuarios de PAL pueden ejecutar sp_helppublication.