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.
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 sysname y su valor predeterminado es %.[ @found= ] **'found'**OUTPUT
Es un marcador para indicar 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'
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 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:
ValorDescripció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. |
Valores de código de retorno
0 (correcto) o 1 (error)
Notas
sp_helpsubscription se utiliza en la replicación 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.