sp_helpdistributor (Transact-SQL)

Lista informações sobre o Distribuidor, banco de dados de distribuição, diretório de trabalho e conta de usuário do Microsoft SQL Server Agent. Esse procedimento armazenado é executado no Publicador, no banco de dados de publicação ou em qualquer banco de dados.

Convenções de sintaxe da Transact-SQL

Sintaxe

sp_helpdistributor [ [ @distributor= ] 'distributor' OUTPUT ]
    [ , [ @distribdb= ] 'distribdb' OUTPUT ]
    [ , [ @directory= ] 'directory' OUTPUT ]
    [ , [ @account= ] 'account' OUTPUT ]
    [ , [ @min_distretention= ] min_distretention OUTPUT ]
    [ , [ @max_distretention= ] max_distretention OUTPUT ]
    [ , [ @history_retention= ] history_retention OUTPUT ]
    [ , [ @history_cleanupagent= ] 'history_cleanupagent' OUTPUT ]
    [ , [ @distrib_cleanupagent = ] 'distrib_cleanupagent' OUTPUT ]
    [ , [ @publisher = ] 'publisher' ] 
    [ , [ @local = ] 'local' ]
    [ , [ @rpcsrvname= ] 'rpcsrvname' OUTPUT ]
    [ , [ @publisher_type = ] 'publisher_type' OUTPUT ]

Argumentos

• [ @distributor=] 'distributor' OUTPUT
  É o nome do Distribuidor. Distribuidor é sysname, com um padrão de **%**que é o único valor que retorna um conjunto de resultados.

• [ @distribdb=] 'distribdb' OUTPUT
  É o nome do banco de dados de distribuição. distribdb é sysname, com um padrão de %, que é o único valor que retorna um conjunto de rsultados.

• [ @directory=] 'directory' OUTPUT
  É o diretório de trabalho. directory é nvarchar(255), com um padrão de %, que é o único valor que retorna um conjunto de resultados.

• [ @account=] 'account' OUTPUT
  É a conta de usuário do Microsoft Windows. account é nvarchar(255), com um padrão de %, que é o único valor que retorna um conjunto de resultados.

• [ @min_distretention=] min_distretentionOUTPUT
  É o período mínimo de retenção de distribuição, em horas. min_distretention é int, com um padrão -1.

• [ @max_distretention=] max_distretentionOUTPUT
  É o período máximo de retenção de distribuição, em horas. max_distretention é int, com um padrão -1.

• [ @history_retention=] history_retentionOUTPUT
  É o período de retenção de histórico máximo, em horas. history_retention é int, com um padrão de -1.

• [ @history_cleanupagent=] 'history_cleanupagent' OUTPUT
  É o nome do agente de limpeza de histórico. history_cleanupagent é nvarchar(100), com um padrão de %, que é o único valor que retorna um conjunto de resultados.

• [ @distrib_cleanupagent =] 'distrib_cleanupagent' OUTPUT
  É o nome do agente de limpeza de distribuição. distrib_cleanupagent é nvarchar(100), com um padrão de %, que é o único valor que retorna um conjunto de resultados.

• [ @publisher=] 'publisher'
  É o nome do Publicador. publisher é sysname, com um padrão de NULL.

• [ @local=] 'local'
  É se SQL Server deve obter valores de servidor locais. local é nvarchar (5), com um padrão de NULL.

• [ @rpcsrvname=] 'rpcsrvname' OUTPUT
  É o nome do servidor que emite chamadas de procedimento remoto. rpcsrvname é sysname, com um padrão de %, que é o único valor que retorna um conjunto de resultados.

• [ @publisher_type= ] 'publisher_type' OUTPUT
  É o tipo de publicador do Publicador. publisher_type é sysname, com um padrão de %, que é o único valor que retorna um conjunto de resultados.

Conjuntos de resultados

Nome da coluna	Tipo de dados	Descrição
distributor	sysname	Nome do Distribuidor.
distribution database	sysname	Nome do banco de dados de distribuição.
directory	nvarchar(255)	Nome do diretório de trabalho.
account	nvarchar(255)	Nome da conta de usuário do Windows
min distrib retention	int	Período mínimo de retenção de distribuição.
max distrib retention	int	Período máximo de retenção de distribuição.
history retention	int	Período de retenção do histórico
history cleanup agent	nvarchar(100)	Nome do agente de limpeza do histórico.
distribution cleanup agent	nvarchar(100)	Nome do agente de limpeza da Distribuição.
rpc server name	sysname	Nome do Distribuidor local ou remoto.
rpc login name	sysname	Logon usado para chamadas de procedimento remoto ao Distribuidor remoto.
publisher type	sysname	Tipo de Publicador, que pode ser um dos seguintes: MSSQLSERVER ORACLE ORACLE GATEWAY

Valores de código de retorno

0 (êxito) ou 1 (falha)

Comentários

sp_helpdistributor é usado em todos os tipos de replicação.

Se um ou mais parâmetros de saída forem especificados na execução de sp_helpdistributor, todos os parâmetros de saída definidos como NULL terão valores atribuídos na saída e nenhum conjunto de resultados será retornado. Se nenhum parâmetro de saída for especificado, um conjunto de resultados será retornado.

Permissões

As colunas de conjuntos de resultados seguintes ou os parâmetros de saída serão retornados aos membros da função de servidor fixa sysadmin no Publicador e aos membros da função de banco de dados fixa db_owner no banco de dados de publicação:

Coluna de conjunto de resultados	Parâmetro de saída
account	@account
min distrib retention	@min_distretention
max distrib retention	@max_distretention
history retention	@history_retention
history cleanup agent	@history_cleanupagent
distribution cleanup agent	@distrib_cleanupagent
rpc login name	none

A coluna de conjunto de resultados seguinte é retornada aos usuários na lista de acesso à publicação no Distribuidor:

• directory

As colunas de conjunto de resultados a seguir são retornadas a todos os usuários.

Coluna de conjunto de resultados	Parâmetro de saída
distributor	@distributor
distribution database	@distribdb
rpc server name	@rpcsrvname
publisher type	@publisher_type

Consulte também

Tarefas

Como exibir e modificar propriedades do Publicador e do Distribuidor (Programação Transact-SQL de replicação)

Referência

sp_adddistpublisher (Transact-SQL)

sp_dropdistpublisher (Transact-SQL)