sp_helpdistributor (Transact-SQL)

  • Artikel

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

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_sauber upagent' OUTPUT

Der Name des Verlaufs sauber up-Agents. @history_sauber upagent ist nvarchar(100), mit einem Standardwert von %, der der einzige Wert ist, der ein Resultset zurückgibt.

[ @distrib_cleanupagent = ] 'distrib_sauber upagent' OUTPUT

Der Name des Verteilungs-sauber up-Agents. @distrib_sauber upagent 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
-ORACLE
- ORACLE GATEWAY

Rückgabecodewerte

0 (Erfolg) 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_sauber upagent
distribution cleanup agent @distrib_sauber upagent
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

Zugehöriger Inhalt