sp_replicationdboption (Transact-SQL)

  • Artikel

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 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)

Hilfe und Informationen

Informationsquellen für SQL Server 2005