• Article

Procédure : spécifier un programme de résolution des articles de fusion (programmation Transact-SQL de la réplication)

Lors de la définition d'un article pour une publication de fusion, vous pouvez spécifier un outil personnalisé de résolution des conflits. Pour plus d'informations, consultez Détection et résolution avancées des conflits de réplication de fusion. MicrosoftSQL Server inclut plusieurs outils personnalisés de résolution des conflits prédéfinis, mais vous pouvez écrire votre outils. Si vous devez implémenter une logique personnalisée qui est exécutée pour chaque ligne répliquée, pas seulement pour les lignes en conflit, consultez Procédure : implémenter un gestionnaire de logique métier pour un article de fusion (programmation de la réplication).

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) au niveau du serveur de publication dans toute 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 information 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) au niveau du 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 programmes de résolution s'appuyant sur l'architecture COM, spécifiez le CLSID de la DLL pour @resolver_clsid, et pour un gestionnaire de logique métier, affectez la valeur true à @is_dotnet_assembly, spécifiez le nom de l'assembly pour @dotnet_assembly_name et le nom complet de la classe qui remplace BusinessLogicModule pour @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\100\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 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 du fichier exécutable de l'Agent de fusion est C:\Program Files\Microsoft SQL Server\100\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 value du jeu de résultats.

  3. Dans la base de données de publication sur le serveur 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 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 value du jeu de résultats.

  3. Dans la base de données de publication sur le serveur 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 toute entrée requise pour le programme de résolution personnalisé, exécutez de nouveau 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 les entrées requises, 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 value du jeu de résultats.

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

Exemple

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