• Artikel

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.

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 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 Vorgehensweise: Aktivieren koordinierter Sicherungen für die Transaktionsreplikation (Replikationsprogrammierung mit Transact-SQL).

  • [ @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 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 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 Veröffentlichungsdatenbank online ist. Wenn für die Veröffentlichungsdatenbank 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.