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.
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 |