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

CETTE RUBRIQUE S’APPLIQUE À :ouiSQL Server (à partir de la version 2008)nonAzure SQL DatabasenonAzure SQL Data Warehouse nonParallel Data Warehouse THIS TOPIC APPLIES TO:yesSQL Server (starting with 2008)noAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

Définit une option de base de données de réplication pour la base de données spécifiée.Sets a replication database option for the specified database. Cette procédure stockée est exécutée sur n'importe quelle base de données de l'abonné au niveau du serveur de publication ou de l'Abonné.This stored procedure is executed at the Publisher or Subscriber on any database.

Icône de lien de rubrique Conventions de la syntaxe Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SyntaxeSyntax


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

ArgumentsArguments

[@dbname=] 'dbname'[@dbname=] 'dbname'
Base de données pour laquelle l'option de base de données de réplication doit être définie.Is the database for which the replication database option is being set. db_name est sysname, sans valeur par défaut.db_name is sysname, with no default.

[@optname=] 'optname'[@optname=] 'optname'
Option de base de données de réplication à activer ou à désactiver.Is the replication database option to enable or disable. optname est sysname, et peut prendre l’une des valeurs suivantes.optname is sysname, and can be one of these values.

ValeurValue DescriptionDescription
publication de fusionmerge publish La base de données peut être utilisée pour les publications de fusion.Database can be used for merge publications.
publierpublish La base de données peut être utilisée pour les autres types de publications.Database can be used for other types of publications.
s’abonnersubscribe La base de données est une base de données d'abonnement.Database is a subscription database.
synchronisation avec la sauvegardesync with backup La base de données est activée pour la sauvegarde coordonnée.Database is enabled for coordinated backup. Pour plus d’informations, consultez activer les sauvegardes coordonnées pour la réplication transactionnelle ( Programmation Transact-SQL ) .For more information, see Enable Coordinated Backups for Transactional Replication (Replication Transact-SQL Programming).

[ @value=] 'valeur'[ @value=] 'value'
Indique si l'option de base de données de réplication doit être activée ou désactivée.Is whether to enable or disable the given replication database option. valeur est sysnameet peut être true ou false.value is sysname, and can be true or false. Lorsque cette valeur est false et optname est publication de fusion, les abonnements à la base de données publiée de fusion sont également supprimés.When this value is false and optname is merge publish, subscriptions to the merge published database are also dropped.

[ @ignore_distributor=] ignore_distributor[ @ignore_distributor=] ignore_distributor
Indique si cette procédure stockée est exécutée sans se connecter au serveur de distribution.Indicates whether this stored procedure is executed without connecting to the Distributor. ignore_distributor est bits, avec une valeur par défaut 0, ce qui signifie que le serveur de distribution doit être connecté à et mis à jour avec le nouvel état de la base de données de publication.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. La valeur 1 doit être spécifié uniquement si le serveur de distribution est inaccessible et sp_replicationdboption est utilisé pour désactiver la publication.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[ @from_scripting=] from_scripting
Identifié à titre d'information uniquement.Identified for informational purposes only. Non pris en charge.Not supported. La compatibilité future n'est pas garantie.Future compatibility is not guaranteed.

Valeurs des codes de retourReturn Code Values

0 (réussite) ou 1 (échec)0 (success) or 1 (failure)

NotesRemarks

sp_replicationdboption est utilisé dans la réplication de capture instantanée, la réplication transactionnelle et la réplication de fusion.sp_replicationdboption is used in snapshot replication, transactional replication, and merge replication.

Cette procédure crée ou supprime des tables système de réplication spécifiques, des comptes de sécurité, etc., en fonction des options choisies.This procedure creates or drops specific replication system tables, security accounts, and so on, depending on the options given. Définit la catégorie correspondante bit dans le master.sysdatabases (table système) et crée les tables système nécessaires.Sets the corresponding category bit in the master.sysdatabases system table and creates the necessary system tables.

Pour désactiver la publication, la base de données de publication doit être en ligne.To disable publishing, the publication database must be online. Si un instantané existe pour la base de données de publication, elle doit être supprimée pour pouvoir désactiver la publication.If a database snapshot exists for the publication database, it must be dropped before disabling publishing. Un instantané de base de données est une copie en lecture seule hors ligne d'une base de données et n'est pas lié à un instantané de réplication.A database snapshot is a read-only offline copy of a database, and is not related to a replication snapshot. Pour plus d’informations, consultez Instantanés de base de données (SQL Server).For more information, see Database Snapshots (SQL Server).

PermissionsPermissions

Seuls les membres de la sysadmin du rôle serveur fixe peuvent exécuter sp_replicationdboption.Only members of the sysadmin fixed server role can execute sp_replicationdboption.

Voir aussiSee Also

Configurer la publication et la distribution Configure Publishing and Distribution
Create a Publication Create a Publication
Supprimer une Publication Delete a Publication
Désactiver la publication et la distribution Disable Publishing and Distribution
Sys.sysdatabases ( Transact-SQL ) sys.sysdatabases (Transact-SQL)
Procédures stockées de réplication (Transact-SQL)Replication Stored Procedures (Transact-SQL)