sp_changemergesubscription (Transact-SQL)

S’applique à :SQL Server

Modifie les propriétés sélectionnées d'un abonnement de fusion par envoi de données (push). Cette procédure stockée est exécutée sur le serveur de publication dans la base de données de publication.

Important

Lors de la configuration d'un serveur de publication avec un serveur de distribution distant, les valeurs fournies pour tous les paramètres, y compris job_login et job_password, sont envoyées en texte brut au serveur de distribution. Vous devez chiffrer la connexion entre le serveur de publication et son serveur de distribution distant avant d'exécuter cette procédure stockée. Pour plus d’informations, consultez Configurer le moteur de base de données SQL Server pour le chiffrement des connexions.

Syntaxe

sp_changemergesubscription
    [ [ @publication = ] N'publication' ]
    [ , [ @subscriber = ] N'subscriber' ]
    [ , [ @subscriber_db = ] N'subscriber_db' ]
    [ , [ @property = ] N'property' ]
    [ , [ @value = ] N'value' ]
    [ , [ @force_reinit_subscription = ] force_reinit_subscription ]
[ ; ]

Arguments

[ @publication = ] N’publication'

Nom de la composition à modifier. @publication est sysname, avec la valeur par défaut NULL. La publication doit déjà exister et respecter les règles applicables aux identificateurs.

[ @subscriber = ] N’subscriber'

Nom de l'Abonné. @subscriber est sysname, avec la valeur par défaut NULL.

[ @subscriber_db = ] N’subscriber_db'

Nom de la base de données d’abonnement. @subscriber_db est sysname et peut être l’une des valeurs du tableau suivant.

[ @property = ] N’property'

Propriété à modifier pour la publication donnée. @property est sysname et peut être l’une des valeurs du tableau suivant.

[ @value = ] N’value'

Nouvelle valeur de la @property spécifiée. @value est nvarchar(255), avec la valeur par défaut NULL.

Propriété Valeur Description
description Description de cet abonnement de fusion.
priority Priorité de l’abonnement. La priorité est utilisée par le résolveur par défaut pour déterminer un gagnant lorsque des conflits sont détectés.
merge_job_login Connectez-vous au compte Microsoft Windows sous lequel l’agent s’exécute.
merge_job_password Mot de passe du compte Windows sous lequel l’agent s’exécute.
publisher_security_mode 1 Utiliser l'authentification Windows pour la connexion au serveur de publication.
0 Utilisez l’authentification SQL Server lors de la connexion au serveur de publication.
publisher_login Nom de connexion du côté du serveur de publication.
publisher_password Mot de passe renforcé pour la connexion au serveur de publication.
subscriber_security_mode 1 Utilise l'authentification Windows pour la connexion à l'Abonné.
0 Utilisez l’authentification SQL Server lors de la connexion à l’Abonné.
subscriber_login Nom de la connexion du côté Abonné.
subscriber_password Mot de passe renforcé pour la connexion de l'Abonné.
sync_type automatic Le schéma et les données initiales des tables publiées sont transférés en premier lieu vers l'Abonné.
none L'Abonné dispose déjà du schéma et des données initiales pour les tables publiées ; les données et les tables système sont toujours transférées.
use_interactive_resolver true Autorise la résolution interactive des conflits pour tous les articles autorisant la résolution interactive.
false Les conflits sont automatiquement résolus au moyen d'un programme de résolution par défaut ou personnalisé.
NULL (valeur par défaut) NULL (valeur par défaut)

[ @force_reinit_subscription = ] force_reinit_subscription

Confirme que l'action entreprise par cette procédure stockée peut nécessiter la réinitialisation des abonnements existants. @force_reinit_subscription est bit, avec la valeur par défaut 0.

  • 0 spécifie que les modifications apportées à l’article de fusion n’entraînent pas la réinitialisation de l’abonnement. Si la procédure stockée détecte que la modification requiert la réinitialisation des abonnements, une erreur se produit et aucune modification n'est effectuée.

  • 1 spécifie que les modifications apportées à l’article de fusion réinitialisent les abonnements existants et autorisent la réinitialisation de l’abonnement.

Valeurs des codes de retour

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

Notes

sp_changemergesubscription est utilisé dans la réplication de fusion.

Après avoir modifié le nom de connexion ou le mot de passe d'un Agent, vous devez arrêter et redémarrer celui-ci avant que la modification prenne effet.

Autorisations

Seuls les membres du rôle serveur fixe sysadmin ou db_owner rôle de base de données fixe peuvent s’exécuter sp_changemergesubscription.