sp_helpdistributor (Transact-SQL)

Artikel
05/07/2013

Führt Informationen zum Verteiler, zur Verteilungsdatenbank, zum Arbeitsverzeichnis und zum Benutzerkonto des Microsoft SQL Server-Agents auf. Diese gespeicherte Prozedur wird beim Verleger mit der Veröffentlichungsdatenbank oder einer anderen Datenbank ausgeführt.

Themenlink (Symbol) Transact-SQL-Syntaxkonventionen

Syntax

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 ]

Argumente

[ @distributor=] 'distributor' OUTPUT
Der Name des Verteilers. distributor ist vom sysname-Datentyp, der Standardwert ist %, wobei nur mit diesem Wert ein Resultset zurückgegeben wird.
[ @distribdb=] 'distribdb' OUTPUT
Der Name der Verteilungsdatenbank. distribdb ist vom Datentyp sysname. Der Standardwert ist %, und dies ist der einzige Wert, der ein Resultset zurückgibt.
[ @directory=] 'directory' OUTPUT
Das Arbeitsverzeichnis. directory ist vom Datentyp nvarchar(255). Der Standardwert ist %, und dies ist der einzige Wert, der ein Resultset zurückgibt.
[ @account=] 'account' OUTPUT
Das Microsoft Windows-Benutzerkonto. account* *ist vom Datentyp nvarchar(255). Der Standardwert ist %, und dies ist der einzige Wert, der ein Resultset zurückgibt.
[ @min_distretention=] min_distretentionOUTPUT
Die minimale Beibehaltungsdauer (in Stunden) für die Verteilung. min_distretention ist vom Datentyp int. Der Standardwert ist -1.
[ @max_distretention=] max_distretentionOUTPUT
Die maximale Beibehaltungsdauer (in Stunden) für die Verteilung. max_distretention ist vom Datentyp int. Der Standardwert ist -1.
[ @history_retention=] history_retentionOUTPUT
Die Beibehaltungsdauer (in Stunden) für den Verlauf. history_retention ist vom Datentyp int. Der Standardwert ist -1.
[ @history_cleanupagent=] 'history_cleanupagent' OUTPUT
Der Name des Verlaufscleanup-Agents. history_cleanupagent ist vom Datentyp nvarchar(100). Der Standardwert ist %, und dies ist der einzige Wert, der ein Resultset zurückgibt.
[ @distrib_cleanupagent =] 'distrib_cleanupagent' OUTPUT
Der Name des Verteilungscleanup-Agents. distrib_cleanupagent ist vom Datentyp nvarchar(100). Der Standardwert ist %, und dies ist der einzige Wert, der ein Resultset zurückgibt.
[ @publisher=] 'publisher'
Der Name des Verlegers. publisher ist vom Datentyp sysname und hat den Standardwert NULL.
[ @local=] 'local'
Gibt an, ob SQL Server lokale Serverwerte abruft. local ist vom Datentyp nvarchar(5) und hat den Standardwert NULL.
[ @rpcsrvname=] 'rpcsrvname' OUTPUT
Der Name des Servers, der Remoteprozeduraufrufe ausgibt. rpcsrvname ist vom Datentyp sysname. Der Standardwert ist %, und dies ist der einzige Wert, der ein Resultset zurückgibt.
[ @publisher_type= ] 'publisher_type' OUTPUT
Der Verlegertyp des Verlegers. publisher_type ist vom Datentyp sysname. Der Standardwert ist %, und dies ist der einzige Wert, der ein Resultset zurückgibt.

Resultsets

Spaltenname	Datentyp	Beschreibung
Verteiler	sysname	Name des Verteilers.
distribution database	sysname	Name der Verteilungsdatenbank.
directory	nvarchar(255)	Name des Arbeitsverzeichnisses.
account	nvarchar(255)	Name des Windows-Benutzerkontos.
min distrib retention	int	Minimale Beibehaltungsdauer für die Verteilung.
max distrib retention	int	Maximale Beibehaltungsdauer für die Verteilung.
history retention	int	Aufbewahrungdauer für Verlauf.
history cleanup agent	nvarchar(100)	Name des Verlaufscleanup-Agents.
distribution cleanup agent	nvarchar(100)	Name des Verteilungscleanup-Agents.
rpc server name	sysname	Name des lokalen Verteilers oder Remoteverteilers.
rpc login name	sysname	Anmeldename, der für Remoteprozeduraufrufe an den Remoteverteiler verwendet wird.
publisher type	sysname	Der Verlegertyp. Die folgenden Typen sind möglich: MSSQLSERVER ORACLE ORACLE GATEWAY

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Hinweise

sp_helpdistributor wird für alle Replikationstypen verwendet.

Wenn ein oder mehr Ausgabeparameter beim Ausführen von sp_helpdistributor angegeben wird, werden allen auf NULL gesetzten Ausgabeparameter beim Beenden Werte zugeordnet. Es wird kein Resultset zurückgegeben. Wenn keine Ausgabeparameter angegeben werden, wird ein Resultset zurückgegeben.

Berechtigungen

Die folgenden Resultsetspalten oder Ausgabeparameter werden an Mitglieder der festen Serverrolle sysadmin beim Verleger und der festen Datenbankrolle db_owner in der Veröffentlichungsdatenbank zurückgegeben:

Resultsetspalte	Ausgabeparameter
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

Die folgende Resultsetspalte wird an Benutzer in der Veröffentlichungszugriffsliste für eine Veröffentlichung beim Verteiler zurückgegeben:

directory

Die folgenden Resultsetspalten werden an alle Benutzer zurückgegeben.

Resultsetspalte	Ausgabeparameter
distributor	@distributor
distribution database	@distribdb
rpc server name	@rpcsrvname
publisher type	@publisher_type

Siehe auch

Verweis

sp_adddistpublisher (Transact-SQL)

sp_dropdistpublisher (Transact-SQL)

Konzepte

Anzeigen und Ändern der Verteiler- und Verlegereigenschaften

Freigeben über