sp_helpsubscription (Transact-SQL)

Artigo
05/07/2013

Lista informações de assinatura associadas a uma publicação, um artigo, Assinante ou conjunto de assinaturas específico. Esse procedimento armazenado é executado no Publicador, em um banco de dados de publicação.

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

Sintaxe

sp_helpsubscription [ [ @publication = ] 'publication' ] 
    [ , [ @article = ] 'article' ]
    [ , [ @subscriber = ] 'subscriber' ]
    [ , [ @destination_db = ] 'destination_db' ] 
    [ , [ @found=] found OUTPUT ]
    [ , [ @publisher = ] 'publisher' ]

Argumentos

[ @publication = ] 'publication'
É o nome da publicação associada. publication é sysname, com um padrão de %, que retorna todas as informações de assinaturas desse servidor.
[ @article= ] 'article'
É o nome do artigo. article é sysname, com um padrão de %, que retorna todas as informações de assinatura das publicações e Assinantes selecionados. Se for all, somente uma entrada será retornada para a assinatura completa em uma publicação.
[ @subscriber= ] 'subscriber'
É o nome do Assinante no qual obter informações de assinaturas. subscriber é sysname, com um padrão de %, que retorna todas as informações de assinaturas das publicações e Assinantes selecionados.
[ @destination_db= ] 'destination_db'
É o nome do banco de dados de destino. destination_db é sysname, com um padrão de %.
[ @found= ] **'found'**OUTPUT
É um sinalizador para indicar linhas de retorno. foundé int e um parâmetro de OUTPUT, com um padrão de 23456.

1 indica que a publicação foi localizada.

0 indica que a publicação não foi localizada.
[ @publisher= ] 'publisher'
É o nome do Publicador. publisher é sysname, com padrão do nome do servidor atual.

Observação

publisher não deve ser especificado, exceto quando for um Publicador Oracle.

Observação
publisher não deve ser especificado, exceto quando for um Publicador Oracle.

Conjuntos de resultados

subscriber

sysname

Nome do Assinante.

publication

sysname

Nome da publicação.

artigo

sysname

Nome do artigo.

destination database

sysname

Nome do banco de dados de destino no qual os dados replicados são colocados.

subscription status

tinyint

O status da assinatura:

0 = Inativo

1 = Assinado

2 = Ativo

synchronization type

tinyint

O tipo de sincronização da assinatura:

1 = Automático

2 = Nenhum

subscription_type

int

O tipo de assinatura:

0 = Push

1 = Pull

2 = Anônimo

full subscription

bit

Se a assinatura é para todos os artigos na publicação:

0 = Não

1 = Sim

subscription name

nvarchar(255)

O nome da assinatura.

update mode

int

0 = Somente leitura

1 = Assinatura da atualização imediata

distribution job id

binary(16)

A ID de trabalho do Distribution Agent.

loopback_detection

bit

A detecção de loopback determina se o Distribution Agent envia transações originadas no Assinante de volta para o Assinante:

0 = Envia de volta.

1 = Não envia de volta.

Usado com replicação transacional bidirecional. Para obter mais informações, consulte Replicação transacional bidirecional.

offload_enabled

bit

Especifica se execução de descarga de um agente de replicação foi definida para executar no Assinante.

Se for 0, o agente será executado no Publicador.

Se for 1, o agente será executado no Assinante.

offload_server

sysname

Nome do servidor habilitado para ativação de agente remota. Se for NULL, então o offload_server atual listado na tabela MSdistribution_agents será usado.

dts_package_name

sysname

Especifica o nome do pacote DTS (Data Transformation Services).

dts_package_location

int

Local do pacote DTS, se um estiver atribuído à assinatura. Se houver um pacote, um valor de 0 especificará o local de pacote no distribuidor. Um valor de 1 especifica o assinante.

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 logon no Assinante.

subscriber_password

A senha do Assinante atual nunca é retornada. O resultado é mascarado por uma cadeia de caracteres "* * * * * *".

job_login

sysname

Nome da conta do Windows na qual o Distribution Agent é executado.

job_password

A senha de trabalho atual nunca é retornada. O resultado é mascarado por uma cadeia de caracteres "* * * * * *".

distrib_agent_name

nvarchar(100)

Nome do trabalho de agente que sincroniza a assinatura.

subscriber_type

tinyint

Tipo do Assinante, que pode ser um dos seguintes:

Value	Descrição
0	Assinante SQL Server
1	Servidor de fontes de dados ODBC
2	Banco de dados Microsoft JET (preterido)
3	Provedor OLE DB

subscriber_provider

sysname

PROGID (identificador programático) exclusivo com o qual o provedor OLE DB para fonte de dados não SQL Server é registrado.

subscriber_datasource

nvarchar(4000)

Nome da fonte de dados conforme entendido pelo provedor OLE DB.

subscriber_providerstring

nvarchar(4000)

Cadeia de conexão específica de provedor OLE DB que identifica a fonte de dados.

subscriber_location

nvarchar(4000)

Local do banco de dados conforme entendido pelo provedor OLE DB

subscriber_catalog

sysname

Catálogo a ser usado ao fazer uma conexão com o provedor OLE DB.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Comentários

sp_helpsubscription é usado em replicação de instantâneo e replicação transacional.

Permissões

As permissões de execução têm como padrão a função public. Só são retornadas informações aos usuários sobre assinaturas criadas por eles. Informações sobre todas as assinaturas são retornadas aos membros da função de servidor fixa sysadmin no Publicador, ou aos membros da função de banco de dados fixa db_owner no banco de dados de publicação.