Artigo
09/28/2010

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.

Ícone de vínculo de tópico Convenções de 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 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.

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

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.