sp_helpsubscription (Transact-SQL)

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 temasConvenciones 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 suscriptores seleccionados. Si es all, sólo 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 toda la información de suscripción de las publicaciones y 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 un indicador que especifica que se devuelven filas. foundes de tipo int, es un parámetro 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'
    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

Nombre de columna

Tipo de datos

Descripción

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.

subscription status

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 = Sólo 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 réplica transaccional bidireccional. Para obtener más información, vea Réplica 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

0Suscriptor de SQL Server

1Servidor del origen de datos ODBC

2Base de datos Microsoft Jet (obsoleto)

3Proveedor 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.

Notas

sp_helpsubscription se utiliza en la réplica de instantáneas y transaccional.

Permisos

De forma predeterminada, los permisos de ejecución corresponden a la función public. Los usuarios sólo reciben información de las suscripciones que hayan creado. La información sobre todas las suscripciones se devuelve a los miembros de la función fija de servidor sysadmin en el publicador o los miembros de la función fija de base de datos db_owner en la base de datos de publicaciones.

Valores de código de retorno

0 (correcto) o 1 (error)

Vea también

Referencia

sp_addsubscription (Transact-SQL)
sp_changesubstatus (Transact-SQL)
sp_dropsubscription (Transact-SQL)
Procedimientos almacenados del sistema (Transact-SQL)

Ayuda e información

Obtener ayuda sobre SQL Server 2005