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

S’APPLIQUE À : ouiSQL Server ouiAzure SQL Database (Managed Instance uniquement) nonAzure SQL Data Warehouse nonParallel Data Warehouse APPLIES TO: yesSQL Server yesAzure SQL Database (Managed Instance only) noAzure 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 de type 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. nom_d 'est est de type sysnameet peut prendre l’une des valeurs suivantes.optname is sysname, and can be one of these values.

ValueValue 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.
publishpublish La base de données peut être utilisée pour les autres types de publications.Database can be used for other types of publications.
Inscrivezsubscribe La base de données est une base de données d'abonnement.Database is a subscription database.
synchroniser 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 des sauvegardes coordonnées pour la programmation ()Transact-SQL de laréplication transactionnelle.For more information, see Enable Coordinated Backups for Transactional Replication (Replication Transact-SQL Programming).

[ @value = ] 'value'Indique s’il faut activer ou désactiver l’option de base de données de réplication donnée.[ @value = ] 'value' Is whether to enable or disable the given replication database option. la valeur est de type sysnameet peut avoir la valeur true ou false.value is sysname, and can be true or false. Lorsque cette valeur est false et que nom_d 'est la 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_distributorIndique si cette procédure stockée est exécutée sans se connecter au serveur de distribution.[ @ignore_distributor = ] ignore_distributor Indicates whether this stored procedure is executed without connecting to the Distributor. ignore_distributor est de valeur bit, avec 0comme valeur par défaut, 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ée 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 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.[ @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 (succès) ou 1 (échec)0 (success) or 1 (failure)

NotesRemarks

sp_replicationdboption est utilisé dans la réplication d’instantané, 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 le bit de catégorie correspondant dans la table système Master. sysdatabases 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).

AutorisationsPermissions

Seuls les membres du rôle serveur fixe sysadmin 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)