Compartilhar via

sp_helpsubscription (Transact-SQL)

  • Artigo

Aplica-se a: SQL Server Instância Gerenciada de SQL do Azure

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.

Convenções de sintaxe de Transact-SQL

Sintaxe

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

Argumentos

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

O nome da publicação associada. @publication é sysname, com um padrão de , que retorna todas as informações de %assinatura para este servidor.

@article [ = ] N'artigo'

O nome do artigo. @article é sysname, com um padrão de , que retorna todas as informações de %assinatura para as publicações e Assinantes selecionados. Se all, apenas uma entrada será retornada para a assinatura completa em uma publicação.

@subscriber [ = ] N'assinante'

O nome do Assinante no qual obter informações de assinatura. @subscriber é sysname, com um padrão de , que retorna todas as informações de %assinatura para as publicações e artigos selecionados.

@destination_db [ = ] N'destination_db'

O nome do banco de dados de destino. @destination_db é sysname, com um padrão de %.

@found [ = ] encontrado SAÍDA

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.

@publisher [ = ] N'editor'

O nome do Editor. @publisher é sysname e o padrão é o nome do servidor atual.

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

Conjunto de resultados

Nome da coluna Tipo de dados Descrição
subscriber sysname Nome do Assinante.
publication sysname Nome da publicação.
article 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 Status da assinatura:

0 = Inativo
1 = Inscrito
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 = Empurrar
1 = Puxar
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 de 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 Bidirectional Transactional Replication.
offload_enabled bit Especifica se a execução de descarregamento de um agente de replicação está definida para ser executada no Assinante.

Se 0, o agente for executado no Publicador.
Se 1, o agente for executado no Assinante.
offload_server sysname Nome do servidor habilitado para ativação de agente remota. Se NULL, então o offload_server atual listado em MSdistribution_agents tabela é 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 especificará o local do 0 pacote no distributor. Um valor de 1 especifica o subscriber.
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 ****** string.
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 ****** string.
distrib_agent_name nvarchar(100) Nome do trabalho de agente que sincroniza a assinatura.
subscriber_type tinyint Tipo de Assinante, que pode ser um dos seguintes valores:

0 = Assinante do SQL Server
1 = servidor de fonte 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 do código de retorno

0 (sucesso) ou 1 (falha).

Comentários

sp_helpsubscription é usado na replicação de instantâneo e 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. As 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.

Conteúdo relacionado