Implementieren eines benutzerdefinierten Konfliktlösers für einen Mergeartikel

  • Artikel

Gilt für:SQL Server

In diesem Thema wird beschrieben, wie Sie einen benutzerdefinierten Konfliktlöser für einen Seriendruckartikel in SQL Server mithilfe von Transact-SQL oder einem COM-basierten benutzerdefinierten Resolver implementieren.

Inhalt

Verwenden von Transact-SQL

Sie können ihren eigenen benutzerdefinierten Konfliktbelöser als transact-SQL-gespeicherte Prozedur in jedem Publisher schreiben. Während der Synchronisierung wird diese gespeicherte Prozedur aufgerufen, wenn in einem Artikel, bei dem der Konfliktlöser registriert wurde, Konflikte auftreten. Informationen zur Konfliktzeile werden vom Merge-Agent an die erforderlichen Parameter der Prozedur übermittelt. Auf gespeicherten Prozeduren basierende benutzerdefinierte Konfliktlöser werden immer auf dem Verleger erstellt.

Hinweis

Microsoft SQL Server-Lösungslöser für gespeicherte Prozeduren werden nur aufgerufen, um Zeilenänderungskonflikte zu behandeln. Sie können nicht zur Behandlung anderer Arten von Konflikten verwendet werden, z. B. von Einfügefehlern, die durch den Verstoß gegen eine PRIMARY KEY-Einschränkung oder einen eindeutigen Index ausgelöst werden.

So erstellen und registrieren Sie einen auf gespeicherten Prozeduren basierenden benutzerdefinierten Konfliktlöser

  1. Erstellen Sie auf dem Verleger entweder in der Veröffentlichungs- oder der msdb -Datenbank eine neue gespeicherte Systemprozedur, welche die folgenden erforderlichen Parameter implementiert:

    Parameter Datentyp Beschreibung
    @tableowner sysname Name des Besitzers der Tabelle, für die ein Konflikt gelöst wird. Dies ist der Besitzer der Tabelle der Veröffentlichungsdatenbank.
    @tablename sysname Name der Tabelle, für die ein Konflikt gelöst wird.
    @rowguid uniqueidentifier Eindeutiger Bezeichner für die Zeile, in der der Konflikt auftritt.
    @subscriber sysname Name des Servers, von dem eine konfliktverursachende Änderung weitergegeben wird.
    @subscriber_db sysname Name der Datenbank, von der eine konfliktverursachende Änderung weitergegeben wird.
    @log_conflict AUSGABE int Legt fest, ob der Mergeprozess einen Konflikt für eine spätere Auflösung protokollieren soll:

    0 = Den Konflikt nicht protokollieren.

    1 = Der Abonnent verliert den Konflikt.

    2 = Der Verleger verliert den Konflikt.
    @conflict_message AUSGABE nvarchar(512) Meldung, die über die Auflösung ausgegeben werden soll, wenn der Konflikt protokolliert wird.
    @destowner sysname Der Besitzer der auf dem Abonnenten veröffentlichten Tabelle.

    Diese gespeicherte Prozedur verwendet die Werte, die vom Merge-Agent an diese Parameter übermittelt werden, um die benutzerdefinierte Konfliktlösungslogik zu implementieren. Sie muss ein einzelnes Zeilenresultset zurückgeben, das in der Struktur mit der Basistabelle identisch ist und die Datenwerte für die gewinnende Version der Zeile enthält.

  2. Gewähren Sie allen Anmeldungen, die von Abonnenten zum Verbindungsaufbau mit dem Verleger verwendet werden, EXECUTE-Berechtigungen für die gespeicherte Prozedur.

Verwenden eines benutzerdefinierten Konfliktlösers mit einem neuen Tabellenartikel

  1. Führen Sie sp_addmergearticle aus, um einen Artikel zu definieren.

  2. Geben Sie für den parameter @article_resolver einen Wert von MicrosoftSQLServer Stored Procedure Resolver an.

  3. Geben Sie den Namen der gespeicherten Prozedur an, die die Konfliktlöserlogik für den parameter @resolver_info implementiert.

    Weitere Informationen finden Sie unter Definieren eines Artikels.

So verwenden Sie einen benutzerdefinierten Konfliktlöser mit einem vorhandenen Tabellenartikel

  1. Führen Sie sp_changemergearticleaus, wobei Sie @publication, @article, den Wert article_resolver für @propertyund einen Wert des MicrosoftSQLKonfliktlösers fürgespeicherte Prozeduren für @valueangeben.

  2. Führen Sie sp_changemergearticleaus, wobei Sie @publication, @article, den Wert resolver_info für @propertyund den Namen der gespeicherten Prozedur, mit der die Konfliktlöserlogik implementiert wird, für @valueangeben.

Verwenden eines COM-basierten benutzerdefinierten Resolvers

Der Microsoft.SqlServer.Replication.BusinessLogicSupport -Namespace implementiert eine Schnittstelle, mit der Sie eine komplexe Geschäftslogik zum Verarbeiten von Ereignissen und zur Lösung von Konflikten schreiben können, die während der Synchronisierung der Mergereplikation eintreten. Weitere Informationen finden Sie unter Implementieren eines Geschäftslogikhandlers für einen Mergeartikel. Sie können auch eine eigene, auf systemeigenem Code basierende benutzerdefinierte Geschäftslogik zur Lösung von Konflikten schreiben. Diese Logik wird als COM-Komponente erstellt und mit Produkten wie Microsoft Visual C++ in Dynamic Link Libraries (DLLs) kompiliert. Ein solcher COM-basierter benutzerdefinierter Konfliktlöser muss die ICustomResolver-Schnittstelle implementieren, die speziell für die Konfliktlösung entworfen wurde.

So erstellen und registrieren Sie einen COM-basierten benutzerdefinierten Konfliktlöser

  1. Fügen Sie in einer COM-kompatiblen Erstellungsumgebung Verweise auf die benutzerdefinierte Konfliktlöserbibliothek hinzu.

  2. Verwenden Sie für ein Visual C++-Projekt die #import-Direktive, um diese Bibliothek in Ihr Projekt zu importieren.

  3. Fügen Sie eine Klasse hinzu, die die ICustomResolver -Schnittstelle implementiert.

  4. Implementieren Sie bestimmte Methoden und Eigenschaften.

  5. Erstellen Sie das Projekt, um die benutzerdefinierte Konfliktlöserbibliotheksdatei zu erstellen.

  6. Stellen Sie die Bibliothek in dem Verzeichnis bereit, das die ausführbare Datei des Merge-Agent (normalerweise \Microsoft SQL Server\100\COM) enthält.

    Hinweis

    Ein benutzerdefinierter Konfliktlöser muss bei einem Pullabonnement auf dem Abonnenten, bei einem Pushabonnement auf dem Verteiler oder auf dem mit der Websynchronisierung verwendeten Webserver bereitgestellt werden.

  7. Registrieren Sie die benutzerdefinierte Konfliktlöserbibliothek folgendermaßen mit „regsvr32.exe“ vom Bereitstellungsverzeichnis aus:

    regsvr32.exe mycustomresolver.dll

  8. Führen Sie im Publisher sp_enumcustomresolvers (Transact-SQL) aus, um zu überprüfen, ob die Bibliothek noch nicht als benutzerdefinierter Konfliktbelöser registriert ist.

  9. Um die Bibliothek als benutzerdefinierter Konfliktlöser zu registrieren, führen Sie sp_registercustomresolver (Transact-SQL) beim Distributor aus. Geben Sie den Anzeigenamen des COM-Objekts für @article_resolver, die Bibliotheks-ID (CLSID) für @resolver_clsidund den Wert false für @is_dotnet_assemblyan.

    Hinweis

    Wenn sie nicht mehr benötigt wird, können Sie die Registrierung eines benutzerdefinierten Konfliktbelösers mithilfe von sp_unregistercustomresolver (Transact-SQL) aufheben.

  10. (Optional) Wiederholen Sie bei einem Cluster die Schritte 6-9, um den benutzerdefinierten Konfliktlöser auf allen Knoten des Clusters zu registrieren. Diese Schritte sind erforderlich, um sicherzustellen, dass der benutzerdefinierte Konfliktlöser nach einem Failover die Synchronisierung korrekt laden kann.

So verwenden Sie einen benutzerdefinierten Konfliktlöser mit einem neuen Tabellenartikel

  1. Führen Sie im Publisher sp_enumcustomresolvers (Transact-SQL) aus, und notieren Sie sich den Anzeigenamen des gewünschten Resolvers.

  2. Führen Sie im Publisher in der Publikationsdatenbank sp_addmergearticle (Transact-SQL) aus, um einen Artikel zu definieren. Geben Sie den Anzeigenamen des Artikelkonfliktlösers aus Schritt 1 für @article_resolveran. Weitere Informationen finden Sie unter Definieren eines Artikels.

So verwenden Sie einen benutzerdefinierten Konfliktlöser mit einem vorhandenen Tabellenartikel

  1. Führen Sie im Publisher sp_enumcustomresolvers (Transact-SQL) aus, und notieren Sie sich den Anzeigenamen des gewünschten Resolvers.

  2. Führen Sie sp_changemergearticle (Transact-SQL) aus, und geben Sie @publication, @article, einen Wert von article_resolver für @property und den Anzeigenamen des Artikelbelösers aus Schritt 1 für @value an.

Siehe auch

Erweiterte Konflikterkennung und -lösung der Mergereplikation
COM-basierte, benutzerdefinierte Konfliktlöser
Bewährte Methoden für die Replikationssicherheit