sp_replicationdboption (Transact-SQL)

S’applique à :SQL ServerAzure SQL Managed Instance

Définit une option de base de données de réplication pour la base de données spécifiée. 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é.

Conventions de la syntaxe Transact-SQL

Syntaxe

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

Arguments

[ @dbname = ] 'dbname' Base de données pour laquelle l’option de base de données de réplication est définie. db_name est sysname, sans valeur par défaut.

[ @optname = ] 'optname' Option de base de données de réplication à activer ou désactiver. optname est sysname et peut être l’une de ces valeurs.

Valeur Description
publication de fusion La base de données peut être utilisée pour les publications de fusion.
publish La base de données peut être utilisée pour les autres types de publications.
s’abonner La base de données est une base de données d'abonnement.
synchroniser avec la sauvegarde La base de données est activée pour la sauvegarde coordonnée. Pour plus d’informations, consultez Activer les sauvegardes coordonnées pour la réplication transactionnelle (programmation Transact-SQL de réplication).

[ @value = ] 'value' Indique s’il faut activer ou désactiver l’option de base de données de réplication donnée. la valeur est sysname et peut être true ou false. Lorsque cette valeur est false et que optname est la publication de fusion, les abonnements à la base de données publiée de fusion sont également supprimés.

[ @ignore_distributor = ] ignore_distributor Indique si cette procédure stockée est exécutée sans se connecter au serveur de distribution. ignore_distributor est bit, avec une valeur par défaut de 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. La valeur 1 doit être spécifiée uniquement si le serveur de distribution est inaccessible et que sp_replicationdboption est utilisé pour désactiver la publication.

[ @from_scripting = ] from_scripting

Identifié à titre d'information uniquement. Non pris en charge. La compatibilité future n'est pas garantie.

Codet de retour

0 (réussite) ou 1 (échec)

Notes

sp_replicationdboption est utilisé dans la réplication instantané, la réplication transactionnelle et la réplication de fusion.

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. Définit le is_published correspondant (réplication transacationnelle ou instantané), is_merge_published (réplication de fusion) ou is_distributor bits dans la table système master.databases et crée les tables système nécessaires.

Pour désactiver la publication, la base de données de publication doit être en ligne. Si un instantané existe pour la base de données de publication, elle doit être supprimée pour pouvoir désactiver la publication. 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. Pour plus d’informations, consultez Instantanés de base de données (SQL Server).

Autorisations

Seuls les membres du rôle serveur fixe sysadmin peuvent exécuter sp_replicationdboption.

Voir aussi

Configurer la publication et la distribution
Créer une publication
Supprimer une publication
Désactiver la publication et la distribution
sys.databases (Transact-SQL)
Procédures stockées de réplication (Transact-SQL)