sp_get_redirected_publisher (Transact-SQL)

Gilt für:SQL Server

Wird von Replikations-Agents verwendet, um einen Verteiler abzufragen, um festzustellen, ob der ursprüngliche Herausgeber umgeleitet wurde.

Transact-SQL-Syntaxkonventionen

Syntax

sp_get_redirected_publisher
    [ @original_publisher = ] N'original_publisher'
    , [ @publisher_db = ] N'publisher_db'
    [ , [ @bypass_publisher_validation = ] bypass_publisher_validation ]
    [ , [ @multi_subnet_failover = ] multi_subnet_failover ]
[ ; ]

Argumente

[ @original_publisher = ] N'original_publisher'

Der Name der Instanz von SQL Server, die die Datenbank ursprünglich veröffentlicht hat. @original_publisher ist "sysname" ohne Standard.

[ @publisher_db = ] N'publisher_db'

Der Name der zu veröffentlichenden Datenbank. @publisher_db ist "sysname" ohne Standard.

[ @bypass_publisher_validation = ] bypass_publisher_validation

Wird verwendet, um die Überprüfung des umgeleiteten Verlegers zu umgehen. Wenn 0, wird die Überprüfung ausgeführt. Wenn 1, wird die Überprüfung nicht ausgeführt. @bypass_publisher_validation ist bit, mit einem Standardwert von 0.

[ @multi_subnet_failover = ] multi_subnet_failover

Gilt für: SQL Server 2022 (16.x) CU 10 und höhere Versionen

Wird verwendet, um Informationen für die Erstellung des dynamischen verknüpften Servers zu übergeben. Wenn 0der dynamische verknüpfte Server nicht mit dem MultiSubnetFailover Parameter erstellt wird. Wenn 1, wird der dynamische verknüpfte Server mit dem MultiSubnetFailover Parameter als 1erstellt. @multi_subnet_failover ist bit, mit einem Standardwert von 0.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler).

Resultset

Spaltenname Datentyp Beschreibung
redirected_publisher sysname Der Name des Verlegers nach der Umleitung.
error_number int Die Fehlernummer des Überprüfungsfehlers.
error_severity int Der Schweregrad des Überprüfungsfehlers.
error_message nvarchar(4000) Der Text der Überprüfungsfehlermeldung.

Hinweise

redirected_publisher gibt den aktuellen Herausgebernamen zurück. Gibt zurück NULL , wenn die Herausgeber- und Veröffentlichungsdatenbanken nicht mithilfe sp_redirect_publishervon umgeleitet werden.

Wenn die Überprüfung nicht angefordert wird oder kein Eintrag für den Herausgeber und die Veröffentlichungsdatenbank vorhanden ist, error_number und error_severity zurückgeben und zurückgeben und zurückgeben 0NULL.error_message

Wenn die Überprüfung angefordert wird, wird die gespeicherte Überprüfungsprozedur sp_validate_redirected_publisher (Transact-SQL) aufgerufen, um zu überprüfen, ob das Ziel der Umleitung ein geeigneter Host für die Veröffentlichungsdatenbank ist. Wenn die Überprüfung erfolgreich ist, sp_get_redirected_publisher wird der Umleitungsherausgebername 0 für die error_number Und error_severity Spalten und NULL in der error_message Spalte zurückgegeben.

Wenn eine Überprüfung angefordert wird und fehlschlägt, wird der umgeleitete Verlegername zusammen mit Fehlerinformationen zurückgegeben.

Berechtigungen

Der Aufrufer muss entweder Mitglied der festen Serverrolle "sysadmin ", der db_owner festen Datenbankrolle für die Verteilungsdatenbank oder ein Mitglied einer Publikationszugriffsliste für eine definierte Publikation sein, die der Herausgeberdatenbank zugeordnet ist.