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ópicoConvençõ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.

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