sp_replicationdboption (Transact-SQL)

Artikel
12/22/2023

Gilt für:SQL Server Azure SQL Managed Instance

Legt für die angegebene Datenbank eine Replikationsdatenbankoption fest. Diese gespeicherte Prozedur wird auf dem Verleger oder Abonnenten für jede Datenbank ausgeführt.

Transact-SQL-Syntaxkonventionen

Syntax

  
sp_replicationdboption [ @dbname= ] 'db_name'   
        , [ @optname= ] 'optname'   
        , [ @value= ] 'value'   
    [ , [ @ignore_distributor= ] ignore_distributor ]  
    [ , [ @from_scripting = ] from_scripting ]

Argumente

[ @dbname = ] 'dbname' Ist die Datenbank, für die die Replikationsdatenbankoption festgelegt wird. db_name ist "sysname" ohne Standard.

[ @optname = ] 'optname' Ist die Replikationsdatenbankoption zum Aktivieren oder Deaktivieren. optname ist sysname und kann einer dieser Werte sein.

Wert	Beschreibung
Zusammenführen der Veröffentlichung	Die Datenbank kann für die Mergeveröffentlichung verwendet werden.
Veröffentlichen	Die Datenbank kann für andere Veröffentlichungstypen verwendet werden.
subscribe	Die Datenbank ist eine Abonnementdatenbank.
Synchronisieren mit Sicherung	Die Datenbank ist für eine koordinierte Sicherung aktiviert. Weitere Informationen finden Sie unter Enable Coordinated Backups for Transactional Replication (Replication Transact-SQL Programming).

[ @value = ] 'value' Gibt an, ob die angegebene Replikationsdatenbankoption aktiviert oder deaktiviert werden soll. der Wert "sysname" ist und "true" oder "false" sein kann. Wenn dieser Wert "false" ist und "optname" veröffentlicht wird, werden Abonnements für die veröffentlichte Zusammenführungsdatenbank ebenfalls gelöscht.

[ @ignore_distributor = ] ignore_distributor Gibt an, ob diese gespeicherte Prozedur ausgeführt wird, ohne eine Verbindung mit dem Distributor herzustellen. ignore_distributor ist bit, mit einem Standardwert von 0, was bedeutet, dass der Distributor mit dem neuen Status der Veröffentlichungsdatenbank verbunden und aktualisiert werden sollte. Der Wert 1 sollte nur angegeben werden, wenn auf den Distributor nicht zugegriffen werden kann und sp_replicationdboption verwendet wird, um die Veröffentlichung zu deaktivieren.

[ @from_scripting = ] from_scripting

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

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Hinweise

sp_replicationdboption wird in Momentaufnahme Replikation, Transaktionsreplikation und Zusammenführungsreplikation verwendet.

Diese Prozedur erstellt oder löscht bestimmte Replikationssystemtabellen, Sicherheitskonten usw. in Abhängigkeit von den gegebenen Optionen. Legt die entsprechende is_published (transacational oder Momentaufnahme Replikation), is_merge_published (Zusammenführungsreplikation) oder is_distributor Bits in der Master.databases-Systemtabelle fest und erstellt die erforderlichen Systemtabellen.

Das Veröffentlichen kann nur deaktiviert werden, wenn die Veröffentlichungsdatenbank online ist. Wenn für die Veröffentlichungsdatenbank eine Datenbankmomentaufnahme vorhanden ist, muss diese vor dem Deaktivieren des Veröffentlichens gelöscht werden. Eine Datenbankmomentaufnahme ist eine schreibgeschützte Offlinekopie einer Datenbank und steht nicht in Verbindung mit einer Replikationsmomentaufnahme. Weitere Informationen finden Sie unter Datenbankmomentaufnahmen (SQL Server).

Berechtigungen

Nur Mitglieder der festen Serverrolle "sysadmin" können sp_replicationdboption ausführen.

Weitere Informationen

Konfigurieren der Veröffentlichung und der Verteilung
Erstellen einer Veröffentlichung
Löschen einer Veröffentlichung
Deaktivieren der Veröffentlichung und Verteilung
sys.databases (Transact-SQL)
Gespeicherte Replikationsprozeduren (Transact-SQL)