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 How to: Enable Coordinated Backups for Transactional Replication (Replication Transact-SQL Programming).

  • [ @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
    À usage interne uniquement.

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 de serveur fixe sysadmin peuvent exécuter sp_replicationdboption.

Voir aussi

Référence

sys.sysdatabases (Transact-SQL)
Procédures stockées de réplication (Transact-SQL)

Autres ressources

How to: Configure Publishing and Distribution (Replication Transact-SQL Programming)
How to: Create a Publication (Replication Transact-SQL Programming)
How to: Delete a Publication (Replication Transact-SQL Programming)
How to: Disable Publishing and Distribution (Replication Transact-SQL Programming)

Aide et Informations

Assistance sur SQL Server 2005