sp_replicationdboption (Transact-SQL)

Article
05/07/2013

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é.

Icône Lien de rubrique Conventions de la syntaxe de 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 doit être définie. db_name est de type sysname, sans valeur par défaut.

[@optname=] 'optname'
Option de base de données de réplication à activer ou à désactiver. optname est de type sysname, et peut prendre l'une des valeurs suivantes.

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 (programmation Transact-SQL de la réplication).

[ @value=] 'value'
Indique si l'option de base de données de réplication doit être activée ou désactivée. value est de type sysname et peut avoir la valeur true ou false. Lorsque cette valeur est false et que optname a la valeur 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 de type bit, avec 0 comme valeur par défaut, ce qui signifie que le serveur de distribution doit être connecté à la base de données de publication et mis à jour avec le nouvel état de cette base. La valeur 1 ne doit être spécifiée que si le serveur de distribution est inaccessible et si 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 (succès) ou 1 (échec)

Notes

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