sp_replicationdboption (Transact-SQL)

  • Artikel

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 = ] N'dbname'
    , [ @optname = ] N'optname'
    , [ @value = ] { N'true' | N 'false' }
    [ , [ @ignore_distributor = ] ignore_distributor ]
    [ , [ @from_scripting = ] from_scripting ]
[ ; ]

Argumente

[ @dbname = ] N'dbname'

Die Datenbank, für die die Replikationsdatenbankoption festgelegt wird. @dbname ist "sysname" ohne Standard.

[ @optname = ] N'optname'

Die Replikationsdatenbankoption zum Aktivieren oder Deaktivieren. @optname ist "sysname" und kann einer dieser Werte sein.

Wert Beschreibung
merge publish Die Datenbank kann für die Mergeveröffentlichung verwendet werden.
publish Die Datenbank kann für andere Veröffentlichungstypen verwendet werden.
subscribe Die Datenbank ist eine Abonnementdatenbank.
sync with backup Die Datenbank ist für eine koordinierte Sicherung aktiviert. Weitere Informationen finden Sie unter "Enable Coordinated Backups for Transactional Replication".

[ @value = ] { N'true' | N 'false' }

Gibt an, ob die angegebene Replikationsdatenbankoption aktiviert oder deaktiviert werden soll. @value ist "sysname" ohne Standard. Wenn dieser Wert und @optname ist false merge publish, 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 Verteiler herzustellen. @ignore_distributor ist bit, mit einem Standardwert von 0.

  • Wenn 0der Distributor mit dem neuen Status der Veröffentlichungsdatenbank verbunden und aktualisiert werden soll.

  • 1 sollte nur angegeben werden, wenn auf den Distributor nicht zugegriffen werden kann und sp_replicationdboption zum Deaktivieren der Veröffentlichung verwendet wird.

[ @from_scripting = ] from_scripting

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

Rückgabecodewerte

0 (erfolgreich) oder 1 Fehler.

Hinweise

sp_replicationdboption wird in der Momentaufnahmereplikation, 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 (Transaktions- oder Momentaufnahmereplikation), 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 ist nicht mit einer Replikationsmomentaufnahme verknüpft. Weitere Informationen finden Sie unter Datenbankmomentaufnahmen (SQL Server).

Berechtigungen

Nur Mitglieder der festen Serverrolle sysadmin können ausgeführt werden sp_replicationdboption.

Zugehöriger Inhalt