sp_replicationdboption (Transact-SQL)
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'
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 bzw. deaktiviert werden soll. optname ist vom Datentyp sysname und kann einen der folgenden Werte annehmen.Wert Beschreibung merge publish
Die Datenbank kann für die Mergepublikation verwendet werden.
publish
Die Datenbank kann für andere Publikationstypen 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 How to: Enable Coordinated Backups for Transactional Replication (Replication Transact-SQL Programming).
- [ @value=] 'value'
Gibt an, ob die entsprechende 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 optnamemerge publish festgelegt ist, werden auch Abonnements für die Datenbank mit Mergeveröffentlichung gelöscht.
- [ @ignore_distributor=] ignore_distributor
Zeigt an, ob diese gespeicherte Prozedur ohne Herstellen einer Verbindung mit dem Verteiler ausgeführt wird. ignore_distributor ist vom Datentyp bit. Der Standardwert ist 0 und bedeutet, dass der Verteiler mit der Verlegerdatenbank verbunden und mit ihrem neuen Status aktualisiert werden soll. 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 zur internen Verwendung.
Rückgabecodewerte
0 (Erfolg) oder 1 (Fehler)
Hinweise
sp_replicationdboption wird bei der Snapshot-, 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 Publikationsdatenbank online ist. Wenn für die Publikationsdatenbank ein Datenbanksnapshot vorhanden ist, muss dieser vor dem Deaktivieren des Veröffentlichens gelöscht werden. Ein Datenbanksnapshot ist eine schreibgeschützte Offlinekopie einer Datenbank und steht nicht in Verbindung mit einem Replikationssnapshot. Weitere Informationen finden Sie unter Datenbanksnapshots.
Berechtigungen
Nur Mitglieder der festen Serverrolle sysadmin können sp_replicationdboption ausführen.
Siehe auch
Verweis
sys.sysdatabases (Transact-SQL)
Gespeicherte Replikationsprozeduren (Transact-SQL)
Andere Ressourcen
How to: Configure Publishing and Distribution (Replication Transact-SQL Programming)
How to: Create a Publication (Replication Transact-SQL Programming)
How to: Delete a Publication (Replication Transact-SQL Programming)
How to: Disable Publishing and Distribution (Replication Transact-SQL Programming)