sp_helpmergesubscription (Transact-SQL)

Artículo
03/07/2014

Devuelve información sobre una suscripción a una publicación de combinación, 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.

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

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'
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 debe 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 una marca para indicar 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 la publicación no se ha encontrado.

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.

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 el solucionador interactivo durante la reconciliación. Si es 0, no se utiliza el solucionador interactivo.
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

Solo los miembros del rol fijo de servidor sysadmin, del rol fijo de base de datos db_owner o de la lista de acceso a la publicación para la publicación a la que pertenece la suscripción pueden ejecutar sp_helpmergesubscription.