• Artikel

Vorgehensweise: Angeben eines Konfliktlösers für Mergeartikel (Replikationsprogrammierung mit Transact-SQL)

Wenn Sie für eine Mergeveröffentlichung einen Artikel definieren, können Sie einen benutzerdefinierten Konfliktlöser angeben. Weitere Informationen hierzu finden Sie unter Erweiterte Konflikterkennung und -lösung bei der Mergereplikation. Microsoft SQL Server beinhaltet einige integrierte benutzerdefinierte Konfliktlöser, Sie können jedoch auch einen eigenen Konfliktlöser schreiben. Wenn Sie benutzerdefinierte Logik implementieren müssen, die für jede replizierte Zeile und nicht nur für Konfliktzeilen ausgeführt werden muss, finden Sie unter Vorgehensweise: Implementieren eines Geschäftslogikhandlers für einen Mergeartikel (Replikationsprogrammierung) nähere Informationen hierzu.

So registrieren Sie einen benutzerdefinierten Konfliktlöser

  1. Wenn Sie einen eigenen benutzerdefinierten Konfliktlöser registrieren möchten, erstellen Sie einen der folgenden Typen:

  2. Um zu bestimmen, ob der gewünschte Konfliktlöser bereits registriert ist, führen Sie sp_enumcustomresolvers (Transact-SQL) auf dem Verleger für eine beliebige Datenbank aus. Daraufhin werden eine Beschreibung des benutzerdefinierten Konfliktlösers sowie der Klassenbezeichner (CLSID) für jeden auf dem Verteiler registrierten COM-basierten Konfliktlöser bzw. Informationen zur verwalteten Assembly für jeden auf dem Verteiler registrierten Geschäftslogikhandler angezeigt.

  3. Wenn der gewünschte benutzerdefinierte Konfliktlöser noch nicht registriert ist, führen Sie auf dem Verteiler sp_registercustomresolver (Transact-SQL) aus. Geben Sie den Namen des Konfliktlösers für @article_resolver an. Bei Geschäftslogikhandlern ist dies der Anzeigenamen der Assembly. Geben Sie für COM-basierte Konfliktlöser den Klassenbezeichner (CLSID) der DLL für @resolver_clsid an, und für einen Geschäftslogikhandler den Wert true für @is_dotnet_assembly, den Namen der Assembly für @dotnet_assembly_name und den vollqualifizierten Namen der Klasse, die BusinessLogicModule überschreibt, für @dotnet_class_name an.

    HinweisHinweis

    Sie müssen den vollständigen Pfad mit dem Assemblynamen für @dotnet_assembly_name angeben, falls die Geschäftslogikhandler-Assembly nicht im gleichen Verzeichnis wie die ausführbare Datei für den Merge-Agent, im gleichen Verzeichnis wie die Anwendung, mit der der Merge-Agent synchron gestartet wird, oder im globalen Assemblycache (GAC) bereitgestellt wird.

  4. Wenn der Konfliktlöser ein COM-basierter Konfliktlöser ist, gehen Sie wie folgt vor:

    • Kopieren Sie die DLL für den benutzerdefinierten Konfliktlöser auf den Verteiler für Pushabonnements oder auf den Abonnenten von Pullabonnements.

      HinweisHinweis

      Benutzerdefinierte Konfliktlöser von Microsoft sind im C:\Programme\Microsoft SQL Server\100\ COM-Verzeichnis enthalten.

    • Verwenden Sie regsvr32.exe, um die benutzerdefinierte Konfliktlöser-DLL im Betriebssystem zu registrieren. Führen Sie beispielsweise folgenden Befehl an der Eingabeaufforderung aus, um den SQL Server-Konfliktlöser Zusatz zu registrieren:

      regsvr32 ssradd.dll

  5. Wenn es sich beim Konfliktlöser um einen Geschäftslogikhandler handelt, stellen Sie die Assembly im gleichen Ordner wie die ausführbare Datei des Merge-Agents (replmerg.exe), im gleichen Ordner wie eine Anwendung, die den Merge-Agent aufruft, oder in dem in Schritt für den @dotnet_assembly_name-Parameter angegebenen Ordner bereit.

    HinweisHinweis

    Der Standardinstallationspfad der ausführbaren Merge-Agent-Datei lautet C:\Programme\Microsoft SQL Server\100\COM.

So geben Sie in der Definition eines Mergeartikels einen benutzerdefinierten Konfliktlöser an

  1. Wenn Sie einen eigenen benutzerdefinierten Konfliktlöser verwenden möchten, erstellen und registrieren Sie den Konfliktlöser wie oben beschrieben.

  2. Führen Sie auf dem Verleger sp_enumcustomresolvers (Transact-SQL) aus, und notieren Sie den Namen des gewünschten benutzerdefinierten Konfliktlösers im value-Feld des Resultsets.

  3. Führen Sie auf dem Verleger für die Veröffentlichungsdatenbank sp_addmergearticle (Transact-SQL) aus. Geben Sie den Namen des Konfliktlösers aus Schritt 2 für @article_resolver und gegebenenfalls alle für den benutzerdefinierten Konfliktlöser erforderlichen Eingaben im Parameter @resolver_info an. Bei benutzerdefinierten Konfliktlösern, die auf einer gespeicherten Prozedur basieren, entspricht @resolver_info dem Namen der gespeicherten Prozedur. Weitere Informationen zu erforderlichen Eingaben für von Microsoft bereitgestellte benutzerdefinierte Konfliktlöser finden Sie unter Microsoft COM-basierte Konfliktlöser.

So geben Sie einen benutzerdefinierten Konfliktlöser für einen vorhandenen Mergeartikel an oder ändern diesen

  1. Um zu bestimmen, ob ein benutzerdefinierter Konfliktlöser für einen Artikel definiert wurde, oder um den Namen des Konfliktlösers abzurufen, führen Sie sp_helpmergearticle (Transact-SQL) aus. Wenn ein benutzerdefinierter Konfliktlöser für einen Artikel definiert wurde, wird dessen Namen im Feld article_resolver angezeigt. Alle dem Konfliktlöser übergegebene Eingaben werden im Feld resolver_info des Resultsets angezeigt.

  2. Führen Sie auf dem Verleger sp_enumcustomresolvers (Transact-SQL) aus, und notieren Sie den Namen des gewünschten benutzerdefinierten Konfliktlösers im value-Feld des Resultsets.

  3. Führen Sie auf dem Verleger für die Veröffentlichungsdatenbank sp_changemergearticle (Transact-SQL) aus. Geben Sie den Wert article_resolver, einschließlich der vollständigen Pfadangabe für Geschäftslogikhandler, für @property und den Namen des gewünschten benutzerdefinierten Konfliktslösers aus Schritt 2 für @value an.

  4. Um erforderliche Eingaben für den benutzerdefinierten Konfliktlöser zu ändern, führen Sie nochmals sp_changemergearticle (Transact-SQL) aus. Geben Sie den Wert resolver_info für @property und alle erforderlichen Eingaben für den benutzerdefinierten Konfliktlöser für @value an. Bei benutzerdefinierten Konfliktlösern, die auf einer gespeicherten Prozedur basieren, entspricht @resolver_info dem Namen der gespeicherten Prozedur. Weitere Informationen zu den erforderlichen Eingaben finden Sie unter Microsoft COM-basierte Konfliktlöser.

So heben Sie die Registrierung eines benutzerdefinierten Konfliktlösers auf

  1. Führen Sie auf dem Verleger sp_enumcustomresolvers (Transact-SQL) aus, und notieren Sie den Namen des zu entfernenden benutzerdefinierten Konfliktlösers im value-Feld des Resultsets.

  2. Führen Sie auf dem Verteiler sp_unregistercustomresolver (Transact-SQL) aus. Geben Sie den vollständigen Namen des benutzerdefinierten Konfliktlösers aus Schritt 1 für **an @article_resolver** an.

Beispiel

In diesem Beispiel wird ein neuer Artikel erstellt und angegeben, dass der SQL Server-Konfliktlöser "Mittelwerterstellung" zur Berechnung des Mittelwerts der Spalte UnitPrice verwendet werden soll, wenn Konflikte auftreten.

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

In diesem Beispiel wird ein Artikel dahingehend geändert, dass der SQL Server-Konfliktlöser "Zusatz" zur Berechnung der Summe der Spalte UnitsOnOrder verwendet werden soll, wenn Konflikte auftreten.

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