sp_helpdistributor (Transact-SQL)

  • Artigo

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

Lista informações sobre o Distribuidor, o banco de dados de distribuição, o diretório de trabalho e a conta de usuário do 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 de 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 [ = ] 'distribuidor' SAÍDA

O nome do Distribuidor. @distributor é sysname, com um padrão de , que é o único valor que retorna um conjunto de %resultados.

@distribdb [ = ] 'distribdb' SAÍDA

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

@directory [ = ] 'diretório' SAÍDA

O diretório de trabalho. @directory é nvarchar(255), com um padrão de , que é o único valor que retorna um conjunto de %resultados.

@account [ = ] 'conta' SAÍDA

A conta de usuário do Windows. @account é nvarchar(255), com um padrão de , que é o único valor que retorna um conjunto de %resultados.

@min_distretention [ = ] min_distretention SAÍDA

O período mínimo de retenção de distribuição, em horas. @min_distretention é int, com um padrão de -1.

@max_distretention [ = ] max_distretention SAÍDA

O período máximo de retenção de distribuição, em horas. @max_distretention é int, com um padrão de -1.

@history_retention [ = ] history_retention SAÍDA

O período de retenção do histórico, em horas. @history_retention é int, com um padrão de -1.

@history_cleanupagent [ = ] SAÍDA 'history_cleanupagent'

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' SAÍDA

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 [ = ] 'editor'

O nome do Editor. @publisher é sysname, com um padrão de NULL.

@local [ = ] 'local'

Se o SQL Server deve obter valores de servidor local. @local é nvarchar(5), com um padrão de NULL.

@rpcsrvname [ = ] 'rpcsrvname' SAÍDA

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' SAÍDA

O tipo de editor do Publicador. @publisher_type é sysname, com um padrão de , que é o único valor que retorna um conjunto de %resultados.

Conjunto 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:

- Servidor MSSQL
-ORÁCULO
- GATEWAY DO ORACLE

Valores do código de retorno

0 (sucesso) 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 durante a execução sp_helpdistributor, todos os parâmetros de saída definidos como NULL receberão valores 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 seguintes colunas de conjunto de resultados ou parâmetros de saída são retornados aos membros da função de servidor fixa sysadmin no Publicador e a db_owner função de banco de dados fixa 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 nenhum

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

  • diretório

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

Conteúdo relacionado