sp_replicationdboption (Transact-SQL)

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 rubriqueConventions 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 avoir 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 Procédure : 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 la procédure stockée est exécutée sans se connecter au serveur de distribution. ignore_distributor est de type bit, avec la valeur par défaut 0, 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 de capture instantanée, 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 une capture instantanée 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 en lecture seule hors ligne d'une base de données et n'est pas liée à une capture instantanée de réplication. Pour plus d'informations, consultez Captures instantanées de base de données.

Autorisations

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