Spécifier un programme de résolution d'articles de fusion

  • Article

Cette rubrique explique comment spécifier un programme de résolution d’articles de fusion dans SQL Server 2014 à l’aide de SQL Server Management Studio ou transact-SQL.

Dans cette rubrique

Avant de commencer

Recommandations

  • La réplication de fusion accepte les types de programmes de résolution d'articles suivants :

  • Pour utiliser un programme de résolution autre que le programme de résolution par défaut, vous devez le copier sur l'ordinateur exécutant l'Agent de fusion et l'inscrire (si vous utilisez un gestionnaire de logique métier, il doit être également inscrit sur le serveur de publication). L'Agent de fusion s'exécute sur :

    • le serveur de distribution pour un abonnement envoyé ;

    • l'Abonné pour un abonnement extrait ;

    • le serveur Microsoft IIS (Internet Information Services) pour un abonnement extrait qui utilise la synchronisation Web.

Utilisation de SQL Server Management Studio

Une fois le programme de résolution inscrit, spécifiez qu’un article doit utiliser le programme de résolution sous l’onglet Résolveur de la boîte de dialogue Propriétés de l’article - <Article> , qui est disponible dans l’Assistant Nouvelle publication et dans la boîte de dialogue Propriétés de publication - <Publication> . Pour plus d’informations sur l’utilisation de l’Assistant et sur l’accès à la boîte de dialogue, consultez Créer une publication et Afficher et modifier les propriétés d’une publication.

Pour spécifier un programme de résolution

  1. Dans la page Articles de l’Assistant Nouvelle publication ou de la boîte de dialogue Propriétés de publication - <Publication> , sélectionnez une table.

  2. Cliquez sur Propriétés de l'articlepuis sur Définir les propriétés de l'article de la table en surbrillance.

  3. Dans la page Propriétés de l’article - <Article> , cliquez sur l’onglet Résolveur .

  4. Sélectionnez Utiliser un résolveur personnalisé (inscrit sur le serveur de distribution) puis, dans la liste, cliquez sur le programme de résolution.

  5. Si le programme de résolution nécessite des entrées (par exemple un nom de colonne), indiquez- les dans la zone de texte Entrez les informations requises par le résolveur .

  6. Cliquez sur OK.

  7. Répétez la procédure pour chaque article exigeant un programme de résolution.

Utilisation de Transact-SQL

Pour inscrire un outil personnalisé de résolution des conflits

  1. Si vous projetez d'inscrire votre propre outil personnalisé de résolution des conflits, créez-en un répondant à l'un des types suivants :

  2. Pour déterminer si le programme de résolution souhaité est déjà inscrit, exécutez sp_enumcustomresolvers (Transact-SQL) sur le serveur de publication sur n’importe quelle base de données. Une description du programme de résolution personnalisé est alors affichée, de même que le CLSID de chaque programme de résolution s'appuyant sur l'architecture COM inscrit sur le serveur de distribution ou des informations sur l'assembly managé pour chaque gestionnaire de logique métier inscrit sur le serveur de distribution.

  3. Si le programme de résolution personnalisé souhaité n’est pas encore inscrit, exécutez sp_registercustomresolver (Transact-SQL) sur le serveur de distribution. Spécifiez un nom pour le programme de résolution pour @article_resolver ; pour un gestionnaire de logique métier, il s’agit du nom convivial de l’assembly. Pour les résolveurs basés sur COM, spécifiez le CLSID de la DLL pour @resolver_clsid, et pour un gestionnaire de logique métier, spécifiez la valeur true pour @is_dotnet_assembly, le nom de l’assembly pour @dotnet_assembly_name et le nom complet de la classe qui remplace BusinessLogicModule pour @dotnet_class_name.

    Notes

    Si un assembly de gestionnaire de logique métier n’est pas déployé dans le même répertoire que l’exécutable Agent de fusion, dans le même répertoire que l’application qui démarre de manière synchrone le Agent de fusion ou dans le global assembly cache (GAC), vous devez spécifier le chemin d’accès complet avec le nom de l’assembly pour @dotnet_assembly_name.

  4. Si le programme de résolution est un programme de résolution s'appuyant sur l'architecture COM :

    • Copiez la DLL de programme de résolution personnalisé sur le serveur de distribution pour les abonnements par émission de données ou sur l'Abonné pour les abonnements par extraction.

      Notes

      Les résolveurs personnalisés Microsoft se trouvent dans le répertoire C:\Program Files\Microsoft SQL Server\120\COM.

    • Utilisez regsvr32.exe pour inscrire la DLL du programme de résolution personnalisé auprès du système d'exploitation. Par exemple, l'exécution de la commande suivante à partir de l'invite de commandes inscrit l'Outil de résolution des conflits d'addition SQL Server :

      regsvr32 ssradd.dll

  5. Si le programme de résolution est un gestionnaire de logique métier, déployez l’assembly dans le même dossier que l’exécutable Agent de fusion (replmerg.exe), dans le même dossier qu’une application qui appelle le Agent de fusion ou dans le dossier spécifié pour le paramètre @dotnet_assembly_name à l’étape 3.

    Notes

    L’emplacement d’installation par défaut de l’exécutable Agent de fusion est C:\Program Files\Microsoft SQL Server\120\COM.

Pour spécifier un programme de résolution personnalisé lors de la définition d'un article de fusion

  1. Si vous projetez d'utiliser un outil personnalisé de résolution des conflits, créez et inscrivez le programme de résolution à l'aide de la procédure précitée.

  2. Sur le serveur de publication, exécutez sp_enumcustomresolvers (Transact-SQL) et notez le nom du programme de résolution personnalisé souhaité dans le champ valeur du jeu de résultats.

  3. Sur le serveur de publication sur la base de données de publication, exécutez sp_addmergearticle (Transact-SQL). Spécifiez le nom du programme de résolution à l’étape 2 pour @article_resolver et toute entrée requise dans le programme de résolution personnalisé à l’aide du paramètre @resolver_info . Pour les résolveurs personnalisés basés sur des procédures stockées, @resolver_info est le nom de la procédure stockée. Pour plus d’informations sur l’entrée nécessaire aux programmes de résolution fournis par Microsoft, consultez Programmes de résolution COM Microsoft.

Pour spécifier ou modifier un programme de résolution personnalisé pour un article de fusion existant

  1. Pour déterminer si un programme de résolution personnalisé a été défini pour un article ou pour obtenir le nom du programme de résolution, exécutez sp_helpmergearticle (Transact-SQL). Si un programme de résolution personnalisé a été défini pour l'article, son nom est affiché dans le champ article_resolver . Toute entrée fournie au programme de résolution est affichée dans le champ resolver_info du jeu de résultats.

  2. Sur le serveur de publication, exécutez sp_enumcustomresolvers (Transact-SQL) et notez le nom du programme de résolution personnalisé souhaité dans le champ valeur du jeu de résultats.

  3. Sur le serveur de publication sur la base de données de publication, exécutez sp_changemergearticle (Transact-SQL). Spécifiez une valeur de article_resolver, y compris le chemin d’accès complet pour les gestionnaires de logique métier, pour @property, et le nom du programme de résolution personnalisé souhaité à l’étape 2 pour @value.

  4. Pour modifier les entrées requises pour le programme de résolution personnalisé, réexécutez sp_changemergearticle (Transact-SQL). Spécifiez une valeur de resolver_info pour @property et toute entrée requise dans le programme de résolution personnalisé pour @value. Pour les résolveurs personnalisés basés sur des procédures stockées, @resolver_info est le nom de la procédure stockée. Pour plus d’informations sur l’entrée nécessaire, consultez Programmes de résolution COM Microsoft.

Pour annuler l'inscription d'un outil personnalisé de résolution des conflits

  1. Sur le serveur de publication, exécutez sp_enumcustomresolvers (Transact-SQL) et notez le nom du programme de résolution personnalisé à supprimer dans le champ valeur du jeu de résultats.

  2. Exécutez sp_unregistercustomresolver (Transact-SQL) sur le serveur de distribution. Spécifiez le nom complet du programme de résolution personnalisé à l’étape 1 pour @article_resolver.

Exemples (Transact-SQL)

Cet exemple crée un article et spécifie que l'Outil de résolution des conflits de moyenne SQL Server doit être utilisé pour calculer la moyenne de la colonne UnitPrice en cas de conflit.

DECLARE @publication AS sysname;
DECLARE @article AS sysname;
SET @publication = 'AdvWorksSalesOrdersMerge';
SET @article = 'Products';

EXEC sp_addmergearticle 
    @publication = @publication, 
    @article = @article, 
    @source_object = @article, 
    @article_resolver = 'Microsoft SQL Server Averaging Conflict Resolver', 
    @resolver_info = 'UnitPrice';
GO

Cet exemple modifie un article de manière à spécifier que l'Outil de résolution des conflits d'addition SQL Server doit être utilisé pour calculer la somme de la colonne UnitsOnOrder en cas de conflit.

DECLARE @publication AS sysname;
DECLARE @article AS sysname;
SET @publication = 'AdvWorksSalesOrdersMerge';
SET @article = 'Products';

EXEC sp_changemergearticle 
    @publication = @publication, 
    @article = @article, 
    @property='article_resolver', 
    @value='Microsoft SQL Server Additive Conflict Resolver';

EXEC sp_changemergearticle 
    @publication = @publication, 
    @article = @article, 
    @property='resolver_info', 
    @value='UnitsOnOrder';
GO

Voir aussi

Advanced Merge Replication Conflict Detection and Resolution
Implémenter un gestionnaire de logique métier pour un article de fusion