sp_replicationdboption (Transact-SQL)sp_replicationdboption (Transact-SQL)

Gilt für: JaSQL Server JaAzure SQL-Datenbank (nur verwaltete Instanz) NeinAzure Synapse Analytics (SQL DW) NeinParallel Data Warehouse APPLIES TO: yesSQL Server yesAzure SQL Database (Managed Instance only) noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse

Legt für die angegebene Datenbank eine Replikationsdatenbankoption fest.Sets a replication database option for the specified database. Diese gespeicherte Prozedur wird auf dem Verleger oder Abonnenten für jede Datenbank ausgeführt.This stored procedure is executed at the Publisher or Subscriber on any database.

Symbol für Themenlink Transact-SQL-SyntaxkonventionenTopic link icon Transact-SQL Syntax Conventions

SyntaxSyntax

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

ArgumenteArguments

[ @dbname = ] 'dbname'Die Datenbank, für die die Replikations Datenbankoption festgelegt wird.[ @dbname = ] 'dbname' Is the database for which the replication database option is being set. db_name ist vom Datentyp vom Datentyp sysnameund hat keinen Standardwert.db_name is sysname, with no default.

[ @optname = ] 'optname'Die Replikations Datenbankoption, die aktiviert oder deaktiviert werden soll.[ @optname = ] 'optname' Is the replication database option to enable or disable. optname ist vom Datentyp vom Datentyp sysname. die folgenden Werte sind möglich:optname is sysname, and can be one of these values.

valueValue BESCHREIBUNGDescription
Zusammenführen der Veröffentlichungmerge publish Die Datenbank kann für die Mergeveröffentlichung verwendet werden.Database can be used for merge publications.
veröffentlichenpublish Die Datenbank kann für andere Veröffentlichungstypen verwendet werden.Database can be used for other types of publications.
abonnierensubscribe Die Datenbank ist eine Abonnementdatenbank.Database is a subscription database.
sync with backupsync with backup Die Datenbank ist für eine koordinierte Sicherung aktiviert.Database is enabled for coordinated backup. Weitere Informationen finden Sie unter aktivieren koordinierter Sicherungen für die Transaktions Replikation (Replikations Programmierung mit Transact-SQL-).For more information, see Enable Coordinated Backups for Transactional Replication (Replication Transact-SQL Programming).

[ @value = ] 'value'Gibt an, ob die angegebene Replikations Datenbankoption aktiviert oder deaktiviert werden soll.[ @value = ] 'value' Is whether to enable or disable the given replication database option. value ist vom Datentyp vom Datentyp sysnameund kann true oder falsesein.value is sysname, and can be true or false. Wenn dieser Wert " false " und " optname " eine Mergeveröffentlichungist, werden die Abonnements für die veröffentlichte Datenbank des Merge ebenfalls gelöscht.When this value is false and optname is merge publish, subscriptions to the merge published database are also dropped.

[ @ignore_distributor = ] ignore_distributorGibt an, ob diese gespeicherte Prozedur ausgeführt wird, ohne eine Verbindung mit dem Verteiler herzustellen.[ @ignore_distributor = ] ignore_distributor Indicates whether this stored procedure is executed without connecting to the Distributor. ignore_distributor ist vom Typ Bitund hat den Standardwert 0. Dies bedeutet, dass der Verteiler mit dem neuen Status der Veröffentlichungs Datenbank verbunden und aktualisiert werden soll.ignore_distributor is bit, with a default of 0, meaning the Distributor should be connected to and updated with the new status of the publishing database. Der Wert 1 sollte nur angegeben werden, wenn auf den Verteiler nicht zugegriffen werden kann und sp_replicationdboption der zum Deaktivieren der Veröffentlichung verwendet wird.The value 1 should be specified only if the Distributor is inaccessible and sp_replicationdboption is being used to disable publishing.

[ @from_scripting = ] from_scripting Nur für Informationszwecke identifiziert.Identified for informational purposes only. Wird nicht unterstützt.Not supported. Zukünftige Kompatibilität wird nicht sichergestellt.Future compatibility is not guaranteed.[ @from_scripting = ] from_scripting Nur für Informationszwecke identifiziert.Identified for informational purposes only. Wird nicht unterstützt.Not supported. Zukünftige Kompatibilität wird nicht sichergestellt.Future compatibility is not guaranteed.

RückgabecodewerteReturn Code Values

0 (Erfolg) oder 1 (Fehler)0 (success) or 1 (failure)

BemerkungenRemarks

sp_replicationdboption wird bei der Momentaufnahme-, Transaktions-und Mergereplikation verwendet.sp_replicationdboption is used in snapshot replication, transactional replication, and merge replication.

Diese Prozedur erstellt oder löscht bestimmte Replikationssystemtabellen, Sicherheitskonten usw. in Abhängigkeit von den gegebenen Optionen.This procedure creates or drops specific replication system tables, security accounts, and so on, depending on the options given. Legt die entsprechenden is_published (Transaktions-oder Momentaufnahme Replikation), is_merge_published (Mergereplikation) oder is_distributor Bits in der Systemtabelle Master. Datenbanken fest und erstellt die erforderlichen Systemtabellen.Sets the corresponding is_published (transacational or snapshot replication), is_merge_published (merge replication), or is_distributor bits in the master.databases system table and creates the necessary system tables.

Das Veröffentlichen kann nur deaktiviert werden, wenn die Veröffentlichungsdatenbank online ist.To disable publishing, the publication database must be online. Wenn für die Veröffentlichungsdatenbank eine Datenbankmomentaufnahme vorhanden ist, muss diese vor dem Deaktivieren des Veröffentlichens gelöscht werden.If a database snapshot exists for the publication database, it must be dropped before disabling publishing. Eine Datenbankmomentaufnahme ist eine schreibgeschützte Offlinekopie einer Datenbank und steht nicht in Verbindung mit einer Replikationsmomentaufnahme.A database snapshot is a read-only offline copy of a database, and is not related to a replication snapshot. Weitere Informationen finden Sie unter Datenbankmomentaufnahmen (SQL Server).For more information, see Database Snapshots (SQL Server).

BerechtigungenPermissions

Nur Mitglieder der festen Server Rolle sysadmin können sp_replicationdboptionausführen.Only members of the sysadmin fixed server role can execute sp_replicationdboption.

Weitere InformationenSee Also

Konfigurieren der Veröffentlichung und der Verteilung Configure Publishing and Distribution
Create a Publication Create a Publication
Löschen einer Veröffentlichung Delete a Publication
Veröffentlichung und Verteilung deaktivieren Disable Publishing and Distribution
sys.databases (Transact-SQL) sys.databases (Transact-SQL)
Gespeicherte Automatisierungsprozeduren (Transact-SQL)Replication Stored Procedures (Transact-SQL)