sp_helpdistributor (Transact-SQL)
Gilt für: 
SQL Server Azure SQL Managed Instance
Listet Informationen über das Verteiler-, Verteilerdatenbank-, Arbeitsverzeichnis und SQL Server-Agent Benutzerkonto auf. Diese gespeicherte Prozedur wird beim Verleger mit der Veröffentlichungsdatenbank oder einer anderen Datenbank ausgeführt.
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 Distributors. @distributor ist "sysname" mit dem Standardwert "%, bei dem es sich um den einzigen Wert handelt, der ein Resultset zurückgibt.
[ @distribdb = ] 'distribdb' OUTPUT
Der Name der Verteilungsdatenbank. @distribdb ist "sysname" mit dem Standardwert "%, bei dem es sich um den einzigen Wert handelt, der ein Resultset zurückgibt.
[ @directory = ] 'directory' OUTPUT
Das Arbeitsverzeichnis. @directory ist nvarchar(255) mit einem Standardwert von %, der der einzige Wert ist, der ein Resultset zurückgibt.
[ @account = ] 'account' OUTPUT
Das Microsoft Windows-Benutzerkonto. @account ist nvarchar(255), mit einem Standardwert von %, der der einzige Wert ist, der ein Resultset zurückgibt.
[ @min_distretention = ] min_distretention OUTPUT
Der minimale Aufbewahrungszeitraum für Verteilungen in Stunden. @min_distretention ist int mit einem Standardwert von -1.
[ @max_distretention = ] max_distretention OUTPUT
Der maximale Verteilungsaufbewahrungszeitraum in Stunden. @max_distretention ist int mit einem Standardwert von -1.
[ @history_retention = ] history_retention OUTPUT
Der Aufbewahrungszeitraum für den Verlauf in Stunden. @history_retention ist int mit einem Standardwert von -1.
[ @history_cleanupagent = ] 'history_cleanupagent' OUTPUT
Der Name des Verlaufsbereinigungs-Agents. @history_cleanupagent ist nvarchar(100), mit einem Standardwert von %, der der einzige Wert ist, der ein Resultset zurückgibt.
[ @distrib_cleanupagent = ] 'distrib_cleanupagent' OUTPUT
Der Name des Verteilungsbereinigungs-Agents. @distrib_cleanupagent ist nvarchar(100), mit einem Standardwert von %, der der einzige Wert ist, der ein Resultset zurückgibt.
[ @publisher = ] 'publisher'
Der Name des Herausgebers. @publisher ist "sysname" mit der Standardeinstellung "NULL.
[ @local = ] 'local'
Gibt an, ob SQL Server lokale Serverwerte abrufen soll. @local ist nvarchar(5), mit einem Standardwert von NULL.
[ @rpcsrvname = ] 'rpcsrvname' OUTPUT
Der Name des Servers, der Remoteprozeduraufrufe ausgibt. @rpcsrvname ist "sysname" mit dem Standardwert "%, bei dem es sich um den einzigen Wert handelt, der ein Resultset zurückgibt.
[ @publisher_type = ] 'publisher_type' OUTPUT
Der Herausgebertyp des Herausgebers. @publisher_type ist "sysname" mit dem Standardwert "%, bei dem es sich um den einzigen Wert handelt, der ein Resultset zurückgibt.
Resultset
| Spaltenname | Datentyp | Beschreibung |
|---|---|---|
distributor |
sysname | Name des Verteilers. |
distribution database |
sysname | Der 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) | Der Name des Verlaufscleanup-Agents. |
distribution cleanup agent |
nvarchar(100) | Der 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 | Typ des Verlegers; kann einer der folgenden sein: - MSSQLSERVER -ORAKEL - ORACLE GATEWAY |
Rückgabecodewerte
0 (erfolgreich) oder 1 Fehler.
Hinweise
sp_helpdistributor wird in allen Replikationstypen verwendet.
Wenn beim Ausführen sp_helpdistributormindestens ein Ausgabeparameter angegeben wird, werden beim Beenden alle ausgabeparameter, die auf NULL festgelegt sind, zugewiesen, und 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 " im Publisher und der db_owner festen Datenbankrolle in der Publikationsdatenbank 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 |
Keine |
Die folgende Resultsetspalte wird an Benutzer in der Veröffentlichungszugriffsliste für eine Veröffentlichung beim Verteiler zurückgegeben:
- verzeichnis
Die folgenden Resultsetspalten werden an alle Benutzer zurückgegeben.
| Resultsetspalte | Ausgabeparameter |
|---|---|
distributor |
@distributor |
distribution database |
@distribdb |
rpc server name |
@rpcsrvname |
publisher type |
@publisher_type |