sp_replicationdboption (Transact-SQL)

S’applique à : SQL Server Azure 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 = ] N'dbname'
    , [ @optname = ] N'optname'
    , [ @value = ] { N'true' | N 'false' }
    [ , [ @ignore_distributor = ] ignore_distributor ]
    [ , [ @from_scripting = ] from_scripting ]
[ ; ]

Arguments

[ @dbname = ] N’dbname'

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

[ @optname = ] N’optname'

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

Valeur Description
merge publish 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.
subscribe La base de données est une base de données d'abonnement.
sync with backup 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.

[ @value = ] { N’true' | N 'false' }

Indique s’il faut activer ou désactiver l’option de base de données de réplication donnée. @value est sysname, sans valeur par défaut. Lorsque cette valeur est false et @optname est merge publish, 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 la valeur par défaut 0.

  • Si 0, le serveur de distribution doit être connecté et mis à jour avec le nouvel état de la base de données de publication.

  • 1 doit être spécifié uniquement si le serveur de distribution est inaccessible et 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.

Valeurs des codes de retour

0 (réussite) or 1 (échec).

Notes

sp_replicationdboption est utilisé dans la réplication d’instantanés, 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 la valeur correspondante is_published (réplication transactionnelle ou d’instantané), is_merge_published (réplication de fusion) ou is_distributor bits dans la master.databases table système 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. Une capture instantanée de base de données est une copie hors connexion en lecture seule d’une base de données et n’est pas liée à un instantané de réplication. Pour plus d’informations, consultez Captures instantanées de base de données (SQL Server).

autorisations

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