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

  • Article

S’applique à :SQL Server

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

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 ;

    • Serveur Microsoft Internet Information Services (IIS) pour un abonnement par extraction 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ésolution des propriétés de l’article - Boîte de dialogue Article - <Article> , 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 - <Page Article>, cliquez sur l’onglet Programme de résolution.

  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 déjà inscrit, exécutez sp_registercustomresolver (Transact-SQL) sur le serveur de distribution. Spécifiez le nom du 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 par @dotnet_class_name.

    Remarque

    Si un assembly de gestionnaire de logique métier n'est pas déployé dans le même répertoire que l'exécutable de l'Agent de fusion, que l'application qui démarre de façon synchronisée l'Agent de fusion ou dans le GAC (Global Assembly Cache), 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.

      Remarque

      Les programmes de résolution personnalisés Microsoft se trouvent dans le répertoire C :\Program Files\Microsoft SQL Server\nnn\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 des éléments suivants à partir de l’invite de commandes inscrit le programme de résolution de conflit additif 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 le fichier exécutable de l'Agent de fusion (replmerg.exe), dans le même dossier qu'une application qui appelle l'Agent de fusion ou dans le dossier spécifié pour le @dotnet_assembly_name à l'étape 3.

    Remarque

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

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 de l'étape 2 pour @article_resolver et toute entrée requise pour le programme de résolution personnalisé à l'aide du paramètre @resolver_info . Pour les programmes de résolution personnalisés s'appuyant sur des procédures stockées, @resolver_info est le nom de la procédure stockée. Pour plus d’informations sur les entrées requises pour les résolveurs fournis par Microsoft, consultez Les programme de résolution com Microsoft.

Spécifier ou changer 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). Affectez la valeur article_resolver, y compris le chemin d'accès complet pour les gestionnaires de logique métier, à @property, et le nom du programme de résolution personnalisé souhaité de l'étape 2 à @value.

  4. Pour modifier toutes les entrées requises pour le programme de résolution personnalisé, réexécutez sp_changemergearticle (Transact-SQL). Affectez la valeur resolver_info à @property et toute entrée requise pour le programme de résolution personnalisé à @value. Pour les programmes de résolution personnalisés s'appuyant 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.

Annuler l’inscription d’un outil de résolution des conflits personnalisé

  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é de l'étape 1 pour @article_resolver.

Exemples (Transact-SQL)

Cet exemple crée un nouvel article et spécifie que le programme de résolution de conflit sql Server Averaging doit être utilisé pour calculer la moyenne de la colonne UnitPrice lorsque des conflits se produisent.

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 montre comment modifier un article pour spécifier l’utilisation du programme de résolution de conflit additif SQL Server pour calculer la somme de la colonne UnitsOnOrder en cas de conflits.

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

Détection et résolution des conflits de réplication de fusion avancée
Implémenter un gestionnaire de logique métier pour un article de fusion