sp_helpsubscription (Transact-SQL)

Artículo
05/08/2013

Presenta la información de suscripción asociada con una publicación particular, un artículo, un suscriptor o un conjunto de suscripciones. Este procedimiento almacenado se ejecuta en el publicador de la base de datos de publicaciones.

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

Sintaxis

sp_helpsubscription [ [ @publication = ] 'publication' ] 
    [ , [ @article = ] 'article' ]
    [ , [ @subscriber = ] 'subscriber' ]
    [ , [ @destination_db = ] 'destination_db' ] 
    [ , [ @found=] found OUTPUT ]
    [ , [ @publisher = ] 'publisher' ]

Argumentos

[ @publication = ] 'publication'
Es el nombre de la publicación asociada. publication es de tipo sysname y su valor predeterminado es %, que devuelve la información de todas las suscripciones del servidor.
[ @article= ] 'article'
Es el nombre del artículo. article es de tipo sysname y su valor predeterminado es %, que devuelve la información de todas las suscripciones de las publicaciones y los suscriptores seleccionados. Si es all, solo se devuelve una entrada por cada suscripción completa a una publicación.
[ @subscriber= ] 'subscriber'
Es el nombre del suscriptor acerca del cual se obtendrá la información de suscripción. subscriber es de tipo sysname y su valor predeterminado es %, que devuelve la información de todas las suscripciones de las publicaciones y los artículos seleccionados.
[ @destination_db= ] 'destination_db'
Es el nombre de la base de datos de destino. destination_db es de tipo sysname y su valor predeterminado es %.
[ @found= ] **'found'**OUTPUT
Es una marca para indicar que se devuelven filas. foundes de tipo int y un parámetro OUTPUT, cuyo 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'
Es el nombre del publicador. publisher es de tipo sysname y su valor predeterminado es el nombre del servidor actual.

[!NOTA]

publisher no debe especificarse, excepto cuando es un publicador de Oracle.

Conjuntos de resultados

subscriber

sysname

Nombre del suscriptor.

publication

sysname

Nombre de la publicación.

article

sysname

Nombre del artículo.

destination database

sysname

Nombre de la base de datos de destino a la que se envían los datos duplicados.

estado de suscripción

tinyint

Estado de la suscripción:

0 = Inactivo

1 = Suscrito

2 = Activo

synchronization type

tinyint

Tipo de sincronización de suscripción:

1 = Automática

2 = Ninguna

subscription type

int

Tipo de suscripción:

0 = Inserción

1 = Extracción

2 = Anónima

full subscription

bit

Indica si la suscripción es a todos los artículos de la publicación:

0 = No

1 = Sí

subscription name

nvarchar(255)

Nombre de la suscripción.

update mode

int

0 = Solo lectura

1 = Suscripción de actualización inmediata

distribution job id

binary(16)

Id. de trabajo del agente de distribución.

loopback_detection

bit

La detección de bucles de retorno determina si el Agente de distribución envía las transacciones originadas en el suscriptor al mismo suscriptor:

0 = Las envía.

1 = No las envía.

Se utilizan con replicación transaccional bidireccional. Para obtener más información, vea Replicación transaccional bidireccional.

offload_enabled

bit

Especifica si se ha establecido que la descarga de un agente de duplicación se lleve a cabo en el suscriptor.

Si es 0, el agente se ejecuta en el publicador.

Si es 1, el agente se ejecuta en el suscriptor.

offload_server

sysname

Nombre del servidor habilitado para la activación remota de agentes. Si es NULL, se utiliza el valor actual de la propiedad offload_server de la tabla MSdistribution_agents.

dts_package_name

sysname

Especifica el nombre del paquete de Servicios de transformación de datos (DTS).

dts_package_location

int

Ubicación del paquete DTS, si se asigna uno a la suscripción. Si hay un paquete, el valor 0 especifica la ubicación del paquete en el distributor. El valor 1 especifica el subscriber.

subscriber_security_mode

smallint

Es el modo de seguridad del suscriptor, donde 1 significa Autenticación de Windows y 0 significa Autenticación de SQL Server.

subscriber_login

sysname

Es el nombre de inicio de sesión del suscriptor.

subscriber_password

La contraseña real del suscriptor no se devuelve nunca. El resultado se enmascara mediante una cadena "******".

job_login

sysname

Nombre de la cuenta de Windows en la que se ejecuta el Agente de distribución.

job_password

La contraseña real del trabajo no se devuelve nunca. El resultado se enmascara mediante una cadena "******".

distrib_agent_name

nvarchar(100)

Nombre del trabajo del agente que sincroniza la suscripción.

subscriber_type

tinyint

Tipo de suscriptor, que puede ser uno de los siguientes:

Valor	Descripción
0	Suscriptor de SQL Server
1	Servidor del origen de datos ODBC
2	Base de datos Microsoft Jet (desusado)
3	Proveedor OLE DB

subscriber_provider

sysname

Identificador de programación único (PROGID) mediante el cual se registra el proveedor OLE DB para los orígenes de datos que no son de SQL Server.

subscriber_datasource

nvarchar(4000)

Nombre del origen de datos tal y como lo entiende el proveedor OLE DB.

subscriber_providerstring

nvarchar(4000)

Cadena de conexión específica del proveedor OLE DB que identifica el origen de datos.

subscriber_location

nvarchar(4000)

Ubicación de la base de datos tal y como la entiende el proveedor OLE DB

subscriber_catalog

sysname

Catálogo que debe utilizarse al establecer una conexión con el proveedor OLE DB.

Valores de código de retorno

0 (correcto) o 1 (error)

Comentarios

sp_helpsubscription se utiliza en la replicación de instantáneas y transaccional.

Permisos

De forma predeterminada, los permisos de ejecución corresponden al rol public. Los usuarios solo reciben información de las suscripciones que hayan creado. La información sobre todas las suscripciones se devuelve a 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 publicaciones.