Artigo
04/01/2012

sp_helpmergesubscription (Transact-SQL)

Retorna informações sobre uma assinatura para uma publicação de mesclagem, push e pull. Esse procedimento armazenado é executado no Publicador no banco de dados de publicação ou em um Assinante de republicação no banco de dados de assinatura.

Ícone de vínculo de tópico Convenções de sintaxe Transact-SQL

Sintaxe

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'
É o nome da publicação. publication é sysname, com um padrão de %. A publicação já deve existir e ser adequada às regras para identificadores. Se for NULL ou %, informações sobre todas as publicações de mesclagem e assinatura no banco de dados atual serão retornadas.
[ @subscriber=] 'subscriber'
É o nome do Assinante. subscriber é sysname, com um padrão de %. Se for NULL ou %, informações sobre todas as assinaturas da publicação determinada serão retornadas.
[ @subscriber_db=] 'subscriber_db'
É o nome do banco de dados de assinatura. subscriber_dbé sysname, com um padrão de %, que retorna informações sobre todos os bancos de dados de assinatura.
[ @publisher=] 'publisher'
É o nome do Publicador. O Publicador deve ser um servidor válido. publisheris sysname, com um padrão de %, que retorna informações sobre todos os Publicadores.
[ @publisher_db=] 'publisher_db'
É o nome do banco de dados Publicador. publisher_dbis sysname, com um padrão de %, que retorna informações sobre todos os bancos de dados Publicadores.
[ @subscription_type=] 'subscription_type'
É o tipo de assinatura. subscription_type é nvarchar(15), e pode ser um destes valores.

Valor

Descrição

push (padrão)

Assinatura push.

pull

Assinatura pull

both

Assinaturas push e pull
[ @found=] 'found'OUTPUT
É um sinalizador para indicar linhas de retorno. found é int e um parâmetro OUTPUT, com um padrão de NULL. 1 indica que a publicação foi localizada. 0 indica que a publicação não foi localizada.

Valor	Descrição
push (padrão)	Assinatura push.
pull	Assinatura pull
both	Assinaturas push e pull

Conjuntos de resultados

Nome da coluna	Tipo de dados	Descrição
subscription_name	sysname	O nome da assinatura.
publication	sysname	O nome da publicação.
publisher	sysname	O nome do Publicador.
publisher_db	sysname	O nome do banco de dados Publicador.
subscriber	sysname	O nome do Assinante.
subscriber_db	sysname	O nome do banco de dados de assinatura.
status	int	O status da assinatura: 0 = Todos os trabalhos estão esperando para iniciar 1 = Um ou mais trabalhos estão iniciando 2 = Todos os trabalhos foram executados com êxito 3 = Pelo menos um trabalho está em execução 4 = Todos os trabalhos estão agendados e ociosos 5 = Pelo menos um trabalho está tentando executar após uma falha anterior 6 = Pelo menos um trabalho falhou em executar com êxito
subscriber_type	int	O tipo de Assinante.
subscription_type	int	O tipo de assinatura: 0 = Push 1 = Pull 2 = Ambos
priority	float(8)	Número que indica a prioridade da assinatura.
sync_type	tinyint	Tipo de sincronização da Assinatura.
description	nvarchar(255)	Descrição breve da assinatura de mesclagem.
merge_jobid	binary(16)	A ID de trabalho do Merge Agent.
full_publication	tinyint	Se a assinatura é para uma publicação completa ou filtrada.
offload_enabled	bit	Especifica se execução de descarga de um agente de replicação foi definida para executar no Assinante. Se for NULL, a execução será executada no Publicador.
offload_server	sysname	Nome do servidor para onde o agente está executando.
use_interactive_resolver	int	Retorna se o resolvedor interativo é usado ou não durante a reconciliação. Se for 0, o resolvedor interativo não será usado.
hostname	sysname	Valor fornecido quando uma assinatura é filtrada pelo valor da função HOST_NAME.
subscriber_security_mode	smallint	É o modo de segurança no Assinante, onde 1 significa Autenticação do Windows e 0 significa Autenticação do Microsoft SQL Server.
subscriber_login	sysname	É o nome de logon no Assinante.
subscriber_password	sysname	A senha do Assinante atual nunca é retornada. O resultado é mascarado por uma cadeia de caracteres "*** * * * * ***".

Valores de código de retorno

0 (êxito) ou 1 (falha)

Comentários

sp_helpmergesubscription é usado em replicação de mesclagem para retornar informações de assinatura armazenadas no Publicador ou Assinante de republicação.

Para assinaturas anônimas, o subscription_type valor é sempre 1 (pull). Porém, você deve executar sp_helpmergepullsubscription no Assinante para obter informações sobre assinaturas anônimas.

Permissões

Somente membros da função de servidor fixa sysadmin ou da função de banco de dados fixa db_owner ou da lista de acesso à publicação para a publicação à qual essa assinatura pertence podem executar sp_helpmergesubscription.