sys.sp_helpdistributor (Transact-SQL)

Gilt für:SQL ServerAzure 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

sys.sp_helpdistributor
    [ [ @distributor = ] N'distributor' OUTPUT ]
    [ , [ @distribdb = ] N'distribdb' OUTPUT ]
    [ , [ @directory = ] N'directory' OUTPUT ]
    [ , [ @account = ] N'account' OUTPUT ]
    [ , [ @min_distretention = ] min_distretention OUTPUT ]
    [ , [ @max_distretention = ] max_distretention OUTPUT ]
    [ , [ @history_retention = ] history_retention OUTPUT ]
    [ , [ @history_cleanupagent = ] N'history_cleanupagent' OUTPUT ]
    [ , [ @distrib_cleanupagent = ] N'distrib_cleanupagent' OUTPUT ]
    [ , [ @publisher = ] N'publisher' ]
    [ , [ @local = ] N'local' ]
    [ , [ @rpcsrvname = ] N'rpcsrvname' OUTPUT ]
    [ , [ @publisher_type = ] N'publisher_type' OUTPUT ]
    [ , [ @deletebatchsize_xact = ] deletebatchsize_xact OUTPUT ]
    [ , [ @deletebatchsize_cmd = ] deletebatchsize_cmd OUTPUT ]
    [ , [ @dist_listener = ] N'dist_listener' OUTPUT ]
[ ; ]

Argumente

[ @distributor = ] N'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 = ] N'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 = ] N'verzeichnis' AUSGABE

Das Arbeitsverzeichnis. @directory ist nvarchar(255) mit einem Standardwert von %, der der einzige Wert ist, der ein Resultset zurückgibt.

[ @account = ] Kein AUSGANG

Das Windows-Benutzerkonto. @account ist nvarchar(255), mit einem Standardwert von %, der der einzige Wert ist, der ein Resultset zurückgibt.

[ @min_distretention = ] min_distretention AUSGABE

Der minimale Aufbewahrungszeitraum für Verteilungen in Stunden. @min_distretention ist int mit einem Standardwert von -1.

[ @max_distretention = ] max_distretention AUSGABE

Der maximale Verteilungsaufbewahrungszeitraum in Stunden. @max_distretention ist int mit einem Standardwert von -1.

[ @history_retention = ] history_retention AUSGABE

Der Aufbewahrungszeitraum für den Verlauf in Stunden. @history_retention ist int mit einem Standardwert von -1.

[ @history_cleanupagent = ] N'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 = ] N'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 = ] N'publisher'

Der Name des Herausgebers. @publisher ist "sysname" mit der Standardeinstellung "NULL.

[ @local = ] N'local'

Gibt an, ob SQL Server lokale Serverwerte abrufen soll. @local ist nvarchar(5), mit einem Standardwert von NULL.

[ @rpcsrvname = ] N'rpcsrvname' AUSGABE

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 = ] N'publisher_type' AUSGABE

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.

[ @deletebatchsize_xact = ] deletebatchsize_xact AUSGABE

Nur für Informationszwecke identifiziert. Wird nicht unterstützt. Zukünftige Kompatibilität wird nicht sichergestellt.

[ @deletebatchsize_cmd = ] deletebatchsize_cmd AUSGABE

Nur für Informationszwecke identifiziert. Wird nicht unterstützt. Zukünftige Kompatibilität wird nicht sichergestellt.

[ @dist_listener = ] N'dist_listener' AUSGABE

Nur für Informationszwecke identifiziert. Wird nicht unterstützt. Zukünftige Kompatibilität wird nicht sichergestellt.

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 zugewiesen NULL , 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