sp_helpdistributor (Transact-SQL)
Restituisce un elenco di informazioni relative a server di distribuzione, database di distribuzione, directory di lavoro e account utente di MicrosoftSQL Server Agent. Questa stored procedure viene eseguita nel database di pubblicazione o in qualsiasi database del server di pubblicazione.
.gif "Icona di collegamento a un argomento")
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 |