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 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 temasConvenciones 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 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

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 (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.

NotaNota
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 = Microsoft SQL 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 = Microsoft SQL Server 2000

50 = Service Pack 1 de SQL Server 2000

60 = Service Pack 3 de SQL Server 2000

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; 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 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 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.

Nota de advertenciaAdvertencia
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)

Comentarios

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 [AdventureWorks2008R2]
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.