sp_helpdistributor (Transact-SQL)

Restituisce un elenco di informazioni relative a server di distribuzione, database di distribuzione, directory di lavoro e account utente di Microsoft SQL Server Agent. Questa stored procedure viene eseguita nel database di pubblicazione o in qualsiasi database del server di pubblicazione.

Icona di collegamento a un argomentoConvenzioni della sintassi Transact-SQL

Sintassi

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 ]

Argomenti

  • [ @distributor=] 'distributor' OUTPUT
    Nome del server di distribuzione. Distributor è di tipo sysname e il valore predefinito è %, l'unico valore che restituisce un set di risultati.

  • [ @distribdb=] 'distribdb' OUTPUT
    Nome del database di distribuzione. distribdb è di tipo sysname e il valore predefinito è %, l'unico valore che restituisce un set di risultati.

  • [ @directory=] 'directory' OUTPUT
    Directory di lavoro. directory è di tipo nvarchar(255) e il valore predefinito è %, l'unico valore che restituisce un set di risultati.

  • [ @account=] 'account' OUTPUT
    Account utente di Microsoft Windows. accountè di tipo nvarchar(255) e il valore predefinito è %, l'unico valore che restituisce un set di risultati.

  • [ @min_distretention=] min_distretentionOUTPUT
    Periodo di memorizzazione minimo per la distribuzione espresso in ore. min_distretention è di tipo int e il valore predefinito è -1.

  • [ @max_distretention=] max_distretentionOUTPUT
    Periodo di memorizzazione massimo per la distribuzione espresso in ore. max_distretention è di tipo int e il valore predefinito è -1.

  • [ @history_retention=] history_retentionOUTPUT
    Periodo di memorizzazione della cronologia espresso in ore. history_retention è di tipo int e il valore predefinito è -1.

  • [ @history_cleanupagent=] 'history_cleanupagent' OUTPUT
    Nome dell'agente per l'eliminazione del contenuto della cronologia. history_cleanupagent è di tipo nvarchar(100) e il valore predefinito è %, l'unico valore che restituisce un set di risultati.

  • [ @distrib_cleanupagent =] 'distrib_cleanupagent' OUTPUT
    Nome dell'agente per l'eliminazione dei riferimenti di distribuzione. distrib_cleanupagent è di tipo nvarchar(100) e il valore predefinito è %, che rappresenta l'unico valore che restituisce un set di risultati.

  • [ @publisher=] 'publisher'
    Nome del server di pubblicazione. publisher è di tipo sysname e il valore predefinito è NULL.

  • [ @local=] 'local'
    Indica se SQL Server deve recuperare o meno i valori del server locale. local è di tipo nvarchar(5) e il valore predefinito è NULL.

  • [ @rpcsrvname=] 'rpcsrvname' OUTPUT
    Nome del server che esegue chiamate di procedure remote. rpcsrvname è di tipo sysname e il valore predefinito è %, l'unico valore che restituisce un set di risultati.

  • [ @publisher_type= ] 'publisher_type' OUTPUT
    Tipo del server di pubblicazione. publisher_type è di tipo sysname e il valore predefinito è % l'unico valore che restituisce un set di risultati.

Set di risultati

Nome colonna

Tipo di dati

Descrizione

distributor

sysname

Nome del server di distribuzione.

distribution database

sysname

Nome del database di distribuzione.

directory

nvarchar(255)

Nome della directory di lavoro.

account

nvarchar(255)

Nome dell'account utente di Windows.

min distrib retention

int

Periodo di memorizzazione minimo per la distribuzione.

max distrib retention

int

Periodo di memorizzazione massimo per la distribuzione.

history retention

int

Periodo di memorizzazione per la cronologia.

history cleanup agent

nvarchar(100)

Nome dell'agente per l'eliminazione del contenuto della cronologia.

distribution cleanup agent

nvarchar(100)

Nome dell'agente per l'eliminazione dei riferimenti di distribuzione.

rpc server name

sysname

Nome del server di distribuzione remoto o locale.

rpc login name

sysname

Account di accesso utilizzato per le chiamate di procedure remote al server di distribuzione remoto.

publisher type

sysname

Tipo di server di pubblicazione. I possibili valori sono i seguenti:

MSSQLSERVER

ORACLE

ORACLE GATEWAY

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Osservazioni

La stored procedure sp_helpdistributor viene utilizzata in tutti i tipi di replica.

Se vengono specificati uno o più parametri di output durante l'esecuzione di sp_helpdistributor, a tutti i parametri di output impostati su NULL vengono assegnati dei valori in fase di uscita e non viene restituito alcun set di risultati. Se non viene specificato alcun parametro di output, viene restituito un set di risultati.

Autorizzazioni

Le colonne del set dei risultati o i parametri di output seguenti vengono restituiti ai membri del ruolo predefinito del server sysadmin nel server di pubblicazione e del ruolo predefinito del database db_owner nel database di pubblicazione:

Colonna del set di risultati

Parametro di output

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

nessuno

La colonna del set dei risultati seguente viene restituita agli utenti nell'elenco di accesso alla pubblicazione per una pubblicazione nel server di distribuzione:

  • directory

Le seguenti colonne del set di risultati vengono restituite a tutti gli utenti.

Colonna del set di risultati

Parametro di output

distributor

@distributor

distribution database

@distribdb

rpc server name

@rpcsrvname

publisher type

@publisher_type