sp_replicationdboption (Transact-SQL)

Artikel
05/07/2013

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

Themenlink (Symbol) Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

[@dbname=] 'dbname'
Die Datenbank, für die die Replikationsdatenbankoption festgelegt wird. db_name ist vom Datentyp sysname und hat keinen Standardwert.

[@optname=] 'optname'
Die Replikationsdatenbankoption, die aktiviert oder deaktiviert werden soll. optname ist vom Datentyp sysname. Die folgenden Werte sind möglich.

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.
Abonnieren	Die Datenbank ist eine Abonnementdatenbank.
sync with backup	Die Datenbank ist für eine koordinierte Sicherung aktiviert. Weitere Informationen finden Sie unter Aktivieren koordinierter Sicherungen für die Transaktionsreplikation (Replikationsprogrammierung mit Transact-SQL).

[ @value=] 'value'
Gibt an, ob die angegebene Replikationsdatenbankoption aktiviert oder deaktiviert wird. value ist vom Datentyp sysname und kann den Wert true oder false haben. Wenn für diesen Wert false und für optname merge publish festgelegt ist, werden auch Abonnements für die Datenbank mit Mergeveröffentlichung 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 vom Datentyp bit. Beim Standardwert 0 wird der Verteiler mit der Veröffentlichungsdatenbank verbunden und mit deren neuem Status aktualisiert. Der Wert 1 sollte nur angegeben werden, wenn auf den Verteiler nicht zugegriffen werden kann und sp_replicationdboption zum Deaktivieren des Veröffentlichens verwendet wird.
[ @from_scripting=] from_scripting
Nur für Informationszwecke identifiziert. Nicht unterstützt. Zukünftige Kompatibilität wird nicht sichergestellt.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Hinweise

sp_replicationdboption wird bei der Momentaufnahme-, Transaktions- und Mergereplikation verwendet.

Diese Prozedur erstellt oder löscht bestimmte Replikationssystemtabellen, Sicherheitskonten usw. in Abhängigkeit von den gegebenen Optionen. Sie legt das entsprechende Kategoriebit in der master.sysdatabases-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 Datenbank-Momentaufnahmen (SQL Server).