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