sp_helpsubscription (Transact-SQL)
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.
.gif "Ícone de vínculo de tópico")
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 assinatura para este servidor.[ @article= ] 'article'
É 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 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 assinatura. subscriber é sysname, com um padrão de %, que retorna todas as informações de assinatura para as publicações e os artigos 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 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 e assume como padrão o nome do servidor atual..gif "Observação")
Observaçãopublisher não deve ser especificado, exceto quando for um Publicador Oracle.
Conjuntos de resultados
Nome da coluna |
Tipo de dados |
Descrição |
|---|---|---|
subscriber |
sysname |
O 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 |
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 auto-retorno 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 de transação 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:
ValorDescrição
0Assinante SQL Server
1Servidor de fontes de dados ODBC
2Banco de dados Microsoft JET (preterido)
3Provedor 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
Execute permissões padrão para a função pública. 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.