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.

Ícone de vínculo de tópicoConvençõ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