sp_helpmergesubscription (Transact-SQL)
Devuelve información sobre una suscripción a una publicación de mezcla, tanto de inserción como de extracción. Este procedimiento almacenado se ejecuta en el publicador de la base de datos de publicaciones o en el suscriptor de republicaciones de la base de datos de suscripciones.
.gif "Icono de vínculo a temas")
Sintaxis
sp_helpmergesubscription [ [ @publication=] 'publication']
[ , [ @subscriber=] 'subscriber']
[ , [ @subscriber_db=] 'subscriber_db']
[ , [ @publisher=] 'publisher']
[ , [ @publisher_db=] 'publisher_db']
[ , [ @subscription_type=] 'subscription_type']
[ , [ @found=] 'found' OUTPUT]
Argumentos
[ @publication=] 'publication'
Es el nombre de la publicación. publication es de tipo sysname y su valor predeterminado es %. La publicación debe existir y debe cumplir las normas de los identificadores. Si es NULL o %, se devuelve información sobre todas las publicaciones y suscripciones de mezcla de la base de datos actual.[ @subscriber=] 'subscriber'
Es el nombre del suscriptor. subscriber es de tipo sysname y su valor predeterminado es %. Si es NULL o %, se devuelve información acerca de todas las suscripciones a la publicación dada.[ @subscriber_db=] 'subscriber_db'
Es el nombre de la base de datos de suscripciones. subscriber_dbes de tipo sysname y su valor predeterminado es %, que devuelve información acerca de todas las bases de datos de suscripciones.[ @publisher=] 'publisher'
Es el nombre del publicador. El publicador tiene que ser un servidor válido. publisheres de tipo sysname y su valor predeterminado es %, que devuelve información sobre todos los publicadores.[ @publisher_db=] 'publisher_db'
Es el nombre de la base de datos del publicador. publisher_dbes de tipo sysname y su valor predeterminado es %, que devuelve información acerca de todas las bases de datos del publicador.[ @subscription_type=] 'subscription_type'
Es el tipo de suscripción. subscription_typees de tipo nvarchar(15) y puede tener uno de estos valores.Valor
Descripción
push (valor predeterminado)
Suscripción de inserción.
pull
Suscripción de extracción.
both
Suscripción de inserción y de extracción.
[ @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 NULL. 1 indica que se ha encontrado la publicación. 0 indica que no se ha encontrado la publicación.
Conjuntos de resultados
Nombre de columna |
Tipo de datos |
Descripción |
|---|---|---|
subscription_name |
sysname |
Nombre de la suscripción. |
publication |
sysname |
Nombre de la publicación. |
publisher |
sysname |
Nombre del publicador. |
publisher_db |
sysname |
Nombre de la base de datos del publicador. |
subscriber |
sysname |
Nombre del suscriptor. |
subscriber_db |
sysname |
Nombre de la base de datos de suscripciones. |
status |
int |
Estado de la suscripción: 0 = Todos los trabajos están esperando el inicio. 1 = Uno o varios trabajos se están iniciando. 2 = Todos los trabajos se han ejecutado correctamente. 3 = Al menos un trabajo se encuentra en ejecución. 4 = Todos los trabajos están programados y se encuentran inactivos. 5 = Se intenta ejecutar al menos un trabajo después de un error anterior. 6 = Al menos un trabajo no se ha ejecutado correctamente. |
subscriber_type |
int |
Tipo de suscriptor. |
subscription_type |
int |
Tipo de suscripción: 0 = Inserción 1 = Extracción 2 = Ambas |
priority |
float(8) |
Número que indica la prioridad de la suscripción. |
sync_type |
tinyint |
Tipo de sincronización de la suscripción. |
description |
nvarchar(255) |
Breve descripción de esta suscripción de mezcla. |
merge_jobid |
binary(16) |
Id. de trabajo del Agente de mezcla. |
full_publication |
tinyint |
Indica si la suscripción es a una publicación completa o filtrada. |
offload_enabled |
bit |
Especifica si se ha establecido que la ejecución de la descarga de un agente de replicación se lleve a cabo en el suscriptor. Si es NULL, la ejecución se lleva a cabo en el publicador. |
offload_server |
sysname |
Nombre del servidor donde se está ejecutando el agente. |
use_interactive_resolver |
int |
Devuelve si se utiliza o no la resolución interactiva durante la reconciliación. Si es 0, no se utiliza la resolución interactiva. |
hostname |
sysname |
Valor proporcionado cuando se filtra una suscripción con el valor de la función HOST_NAME. |
subscriber_security_mode |
smallint |
Es el modo de seguridad del suscriptor, donde 1 significa Autenticación de Windows y 0 significa Autenticación de Microsoft SQL Server. |
subscriber_login |
sysname |
Es el nombre de inicio de sesión del suscriptor. |
subscriber_password |
sysname |
La contraseña del suscriptor real nunca se devuelve. El resultado se enmascara con la cadena "******". |
Valores de código de retorno
0 (correcto) o 1 (error)
Comentarios
sp_helpmergesubscription se utiliza en la replicación de mezcla para devolver información de suscripción almacenada en el publicador o el suscriptor de republicación.
En las suscripciones anónimas, el valor de subscription_typees siempre 1 (extracción). Sin embargo, debe ejecutar sp_helpmergepullsubscription en el suscriptor para obtener información sobre suscripciones anónimas.
Permisos
Sólo los miembros de la función fija de servidor sysadmin, la función fija de base de datos db_owner o la lista de acceso a la publicación para la publicación a la que pertenece la suscripción pueden ejecutar sp_helpmergesubscription.