マージ アーティクルのカスタム競合回避モジュールを実装する
適用対象:
SQL Server
このトピックでは、SQL Server で、Transact-SQL または COM ベースのカスタム競合回避モジュールを使用して、マージ アーティクルのカスタム競合回避モジュールを実装する方法について説明します。
このトピックの内容
以下を使用して、マージ アーティクルのカスタム競合回避モジュールを実装する
Transact-SQL の使用
各パブリッシャーで、固有のカスタム競合回避モジュールを Transact-SQL ストアド プロシージャとして記述できます。 同期中に、競合回避モジュールが登録されたアーティクルで競合が発生すると、このストアド プロシージャが呼び出されます。 マージ エージェントによって、競合している行に関する情報が、プロシージャの必須パラメーターに渡されます。 ストアド プロシージャ ベースのカスタム競合回避モジュールは、常にパブリッシャーで作成されます。
Note
Microsoft SQL Server ストアド プロシージャ競合回避モジュールは、行の変更ベースの競合を処理するためにのみ呼び出されます。 他の種類の競合 (PRIMARY KEY 違反や一意インデックス制約違反によってトリガーされたエラーなど) を処理するためにそれらを使用することはできません。
ストアド プロシージャ ベースのカスタム競合回避モジュールを作成するには
パブリッシャーのパブリケーションまたは msdb データベースで、次の必須パラメーターを実装する新しいシステム ストアド プロシージャを作成します。
パラメーター データ型 説明 @tableowner sysname 競合を解決する対象のテーブルの所有者名。 これは、パブリケーション データベース内のテーブルの所有者です。 @tablename sysname 競合を解決する対象のテーブル名。 @rowguid uniqueidentifier 競合がある行の一意の識別子。 @subscriber sysname 競合する変更の反映元であるサーバーの名前。 @subscriber_db sysname 競合する変更の反映元であるデータベースの名前。 @log_conflict OUTPUT int 後で解決できるように、マージ処理で競合をログに記録するかどうかを設定します。
0 = 競合をログに記録しない。
1 = サブスクライバーは競合で優先されない。
2 = パブリッシャーは競合で優先されない。@conflict_message OUTPUT nvarchar(512) 競合をログに記録する場合の解決に関するメッセージ。 @destowner sysname サブスクライバー側でパブリッシュされたテーブルの所有者。 このストアド プロシージャでは、マージ エージェントによってこれらのパラメーターに渡された値を使用して、カスタム競合解決ロジックが実装されます。 ベース テーブルと構造が同じであり、行の競合するバージョンのデータ値が格納されている単一行の結果セットが返される必要があります。
サブスクライバーでパブリッシャーへの接続に使用される任意のログインに対して、ストアド プロシージャの EXECUTE 権限を許可します。
新しいテーブル アーティクルでカスタム競合回避モジュールを使用する
sp_addmergearticle を実行してアーティクルを定義します。
@article_resolver パラメーターに対して、MicrosoftSQLサーバー ストアド プロシージャ競合回避モジュールの値を指定します。
@resolver_info パラメーターに対して、競合回避ロジックを実装するストアド プロシージャの名前を指定します。
詳しくは、「アーティクルの定義」をご覧ください。
既存のテーブル アーティクルにカスタム競合回避モジュールを使用するには
@publication と @article を指定し、@property に article_resolver の値を、@value に MicrosoftSQLServer Stored ProcedureResolver の値を指定して、sp_changemergearticle を実行します。
@publicationと @articleを指定し、 @propertyに resolver_info の値を、 @valueに競合回避ロジックを実装するストアド プロシージャの名前を指定して、 sp_changemergearticleを実行します。
COM ベースのカスタム競合回避モジュールの使用
Microsoft.SqlServer.Replication.BusinessLogicSupport 名前空間で実装されるインターフェイスを利用して、イベントを処理し、マージ レプリケーション同期処理で発生する競合を回避するための複雑なビジネス ロジックを作成できます。 詳細については、「マージ アーティクルのビジネス ロジック ハンドラーの実装」を参照してください。 また、ネイティブ コード ベースのカスタム ビジネス ロジックを独自に作成して、競合を回避することもできます。 Visual C++ などの製品を使用して、このロジックを COM コンポーネントとしてビルドし、ダイナミック リンク ライブラリ (DLL) にコンパイルします。 この種の COM ベースのカスタム競合回避モジュールには、競合回避専用に設計されている ICustomResolver インターフェイスを実装する必要があります。
COM ベース カスタム競合回避モジュールを作成して登録するには
COM 互換のオーサリング環境で、カスタム競合回避モジュール ライブラリへの参照を追加します。
Visual C++ プロジェクトの場合は、#import ディレクティブを使用してこのライブラリをプロジェクトにインポートします。
ICustomResolver インターフェイスを実装するクラスを作成します。
メソッドとプロパティを実装します。
プロジェクトをビルドして、カスタム競合回避モジュール ライブラリ ファイルを作成します。
マージ エージェントの実行可能ファイルが置かれているディレクトリ (通常は \Microsoft SQL Server\100\COM) に、そのライブラリを配置します。
Note
カスタム競合回避モジュールは、プル サブスクリプションの場合はサブスクライバーに、プッシュ サブスクリプションの場合はディストリビューターに、Web 同期に使用する場合は Web サーバーに配置する必要があります。
次のように、配置先のディレクトリから regsvr32.exe を実行して、カスタム競合回避モジュール ライブラリを登録します。
regsvr32.exe mycustomresolver.dllパブリッシャーで sp_enumcustomresolvers (Transact-SQL) を実行して、そのライブラリがカスタム競合回避モジュールとしてまだ登録されていないことを確認します。
カスタム競合回避モジュールとしてライブラリを登録するには、ディストリビューターで sp_registercustomresolver (Transact-SQL) を実行します。 COM オブジェクトの表示名を @article_resolverに指定し、ライブラリの ID (CLSID) を @resolver_clsidに指定し、 false を @is_dotnet_assemblyに指定します。
Note
カスタム競合回避モジュールが不要になったら、sp_unregistercustomresolver (Transact-SQL) を使用して登録を解除できます。
(省略可) クラスターで手順 6 から 9 を繰り返して、クラスターの全ノードにカスタム競合回避モジュールを登録します。 これらの手順は、フェールオーバーの後にカスタム競合回避モジュールで調整エージェントを適切に読み込むために必要です。
新しいテーブル アーティクルにカスタム競合回避モジュールを使用するには
パブリッシャーで sp_enumcustomresolvers (Transact-SQL) を実行し、目的の競合回避モジュールの表示名をメモします。
パブリッシャー側のパブリケーション データベースに対して、sp_addmergearticle (Transact-SQL) を実行してアーティクルを定義します。 手順 1. で調べたアーティクル競合回避モジュールの表示名を @article_resolverに指定します。 詳しくは、「アーティクルの定義」をご覧ください。
既存のテーブル アーティクルにカスタム競合回避モジュールを使用するには
パブリッシャーで sp_enumcustomresolvers (Transact-SQL) を実行し、目的の競合回避モジュールの表示名をメモします。
sp_changemergearticle (Transact-SQL) を実行し、@publication、@article を指定し、@property に article_resolver 値、@value に手順 1 のアーティクル競合回避モジュールの表示名を指定します。
関連項目
マージ レプリケーションの競合検出および解決の詳細
COM ベースのカスタム競合回避モジュール
レプリケーション セキュリティの推奨事項
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示