sp_helpmergesubscription (Transact-SQL)

Aplica-se a:SQL Server

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.

Convenções de sintaxe de Transact-SQL

Sintaxe

sp_helpmergesubscription
    [ [ @publication = ] N'publication' ]
    [ , [ @subscriber = ] N'subscriber' ]
    [ , [ @subscriber_db = ] N'subscriber_db' ]
    [ , [ @publisher = ] N'publisher' ]
    [ , [ @publisher_db = ] N'publisher_db' ]
    [ , [ @subscription_type = ] N'subscription_type' ]
    [ , [ @found = ] found OUTPUT ]
[ ; ]

Argumentos

@publication [ = ] N'publicação'

O nome da publicação. @publication é sysname, com um padrão de %. A publicação já deve existir e estar em conformidade com as regras para identificadores. Se NULL ou %, as informações sobre todas as publicações e assinaturas de mesclagem no banco de dados atual serão retornadas.

@subscriber [ = ] N'assinante'

O nome do Assinante. @subscriber é sysname, com um padrão de %. Se NULL ou %, as informações sobre todas as assinaturas da publicação em questão serão retornadas.

@subscriber_db [ = ] N'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 [ = ] N'editor'

O nome do Editor. @publisher é sysname, com um padrão de , com um padrão de %%, que retorna informações sobre todos os Publicadores. O Publicador deve ser um servidor válido.

@publisher_db [ = ] N'publisher_db'

O nome do banco de dados Publicador. @publisher_db é sysname, com um padrão de , que retorna informações sobre todos os bancos de dados do %Publisher.

@subscription_type [ = ] N'subscription_type'

O tipo de assinatura. @subscription_type é nvarchar(15) e pode ser um desses valores.

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

@found [ = ] SAÍDA encontrada

Um sinalizador para indicar linhas de retorno. @found é um parâmetro OUTPUT do tipo int.

  • 1 indica que a publicação foi encontrada.
  • 0 indica que a publicação não foi encontrada.

Conjunto de resultados

Nome da coluna Tipo de dados Descrição
subscription_name sysname O nome da assinatura.
publication sysname Nome da publicação.
publisher sysname Nome do Publicador.
publisher_db sysname Nome do banco de dados do Publisher.
subscriber sysname Nome do Assinante.
subscriber_db sysname Nome do banco de dados de assinatura.
status int Status da assinatura:

0 = Todos os trabalhos estão aguardando para iniciar

1 = Um ou mais trabalhos estão começando

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 ser executado após uma falha anterior

6 = Pelo menos um trabalho falhou ao ser executado com êxito
subscriber_type int O tipo de Assinante.
subscription_type int O tipo de assinatura:

0 = Empurrar

1 = Puxar

2 = Ambos
priority flutuador(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) ID do 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 NULL, a execução for 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 0, o resolvedor interativo não for 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 SQL Server.
subscriber_login sysname O nome de login no Assinante.
subscriber_password sysname A senha do Assinante atual nunca é retornada. O resultado é mascarado por uma ****** corda.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Comentários

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

Para assinaturas anônimas, o valor subscription_type é sempre 1 (pull). No entanto, 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, da função de banco de dados fixa db_owner ou da lista de acesso à publicação à qual a assinatura pertence, podem executar sp_helpmergesubscription.