マージ アーティクル間の結合フィルターの定義および変更
適用対象: SQL Server
このトピックでは、SQL Server で、SQL Server Management Studio または Transact-SQL を使用して、統合アーティクル間の結合フィルターを定義して変更する方法について説明します。 マージ レプリケーションでは結合フィルターがサポートされています。結合フィルターは、通常、テーブル分割を他の関連するテーブル アーティクルに拡張するために、パラメーター化されたフィルターと組み合わせて使用されます。
このトピックの内容
作業を開始する準備:
マージ アーティクル間の結合フィルターを定義および変更するために使用するもの:
はじめに
制限事項と制約事項
結合フィルターを作成するには、パブリケーションに少なくとも 2 つの関連テーブルを含める必要があります。 結合フィルターは、行フィルターを拡張したものです。そのため、結合を使用して行フィルターを別のテーブルに拡張するには、先に 1 つのテーブルの行フィルターを定義する必要があります。 結合フィルターを 1 つ定義すると、パブリケーションに追加の関連テーブルが含まれている場合、この結合フィルターは別の結合フィルターを使用して拡張できます。
パブリケーションに対するサブスクリプションが初期化された後に、結合フィルターを追加、変更、または削除した場合は、変更を行った後で、新しいスナップショットを生成し、すべてのサブスクリプションを再初期化する必要があります。 プロパティ変更の要件の詳細については、「Change Publication and Article Properties」(パブリケーションとアーティクルのプロパティの変更) をご覧ください。
推奨事項
- 結合フィルターは、一連のテーブルに対して手動で作成できます。また、テーブルに定義された外部キーと主キーのリレーションシップに基づいて、レプリケーションによって自動的に生成することもできます。 一連の結合フィルターを自動的に生成する方法の詳細については、「Automatically Generate a Set of Join Filters Between Merge Articles (SQL Server Management Studio)」(マージ アーティクル間で一連の結合フィルターを自動的に生成する (SQL Server Management Studio)) をご覧ください。
SQL Server Management Studio を使用する
パブリケーションの新規作成ウィザードの [テーブル行のフィルター選択] ページまたは [パブリケーションのプロパティ - <パブリケーション]> ダイアログ ドロップダウン リストの [行のフィルター選択] ページで、結合フィルターを定義、変更、または削除します。 ウィザードの使用およびダイアログ ボックスへのアクセスの詳細については、「パブリケーションの作成」および「View and Modify Publication Properties」 (パブリケーション プロパティの表示および変更) を参照してください。
結合フィルターを定義するには
パブリケーションの新規作成ウィザードの [テーブル行のフィルター選択] ページ、または [パブリケーションのプロパティ - <パブリケーション]> の [行のフィルター選択] ページで、[フィルター選択されたテーブル] ペイン内の既存の行フィルターまたは結合フィルターを選択します。
[追加]をクリックし、 [選択したフィルターを拡張するために結合を追加する]をクリックします。
JOIN ステートメントを作成します。 [ビルダーを使用してステートメントを作成する] または [JOIN ステートメントを手動で作成する]を選択します。
ビルダーの使用を選択した場合、グリッド内の列 ([結合]、 [フィルター選択されたテーブルの列]、 [演算子]、 [結合テーブルの列]) を使用して JOIN ステートメントを作成します。
グリッド内の各列には、ドロップダウン コンボ ボックスが含まれており、2 つの列と 1 つの演算子 (=、<>、<=、<、>=、>、など) を選択できます。 結果は [プレビュー] テキスト領域に表示されます。 結合に列のペアを複数個含める場合は、 [結合] 列から結合 (AND または OR) を選択し、さらに 2 つの列と 1 つの演算子を入力します。
ステートメントを手動で作成する場合、 [JOIN ステートメント] テキスト領域に JOIN ステートメントを入力します。 [フィルター選択されたテーブルの列] ボックスと [結合テーブルの列] ボックスを使用して、 [JOIN ステートメント] テキスト領域に列をドラッグ アンド ドロップします。
完成した JOIN ステートメントは、次のように表示されます。
SELECT <published_columns> FROM [Sales].[SalesOrderHeader] INNER JOIN [Sales].[SalesOrderDetail] ON [SalesOrderHeader].[SalesOrderID] = [SalesOrderDetail].[SalesOrderID]
JOIN 句には、2 つの部分で構成されている名前を使用する必要があります。3 つまたは 4 つの部分で構成されている名前の使用はサポートされていません。
結合オプションを指定します。
フィルター選択されたテーブル (親テーブル) 内での結合先の列が一意である場合は、 [一意キー]を選択します。
注意事項
このオプションを選択すると、結合フィルターにおける子テーブルと親テーブルのリレーションシップが一対一または一対多となるように指定されます。 子テーブル内で結合する列に制約があり、一意性が保証される場合にのみ、このオプションを選択します。 このオプションを適切に設定しなかった場合、データを収束できない可能性があります。
既定で、マージ レプリケーションでは同期中に行ごとに変化が処理されます。 フィルター選択されたテーブルと結合されたテーブルの両方の行内の関連する変更を 1 つの単位として処理するには、 [論理レコード] (Microsoft SQL Server 2005 (9.x) 以降のバージョンのみ) を選択します。 このオプションは、論理レコードを使用するために必要なアーティクルとパブリケーションの要件が満たされている場合にのみ使用できます。 詳細については、「Group Changes to Related Rows with Logical Records」(論理レコードによる関連行への変更のグループ化) の「Considerations for Using Logical Records」(論理レコードの使用についての注意点) をご覧ください。
[OK] を選択します。
[パブリケーションのプロパティ - <パブリケーション]> ダイアログ ボックスが表示されている場合は、[OK] をクリックして保存し、ダイアログ ボックスを閉じます。
結合フィルターを変更するには
パブリケーションの新規作成ウィザードの [テーブル行のフィルター選択] ページ、または [パブリケーションのプロパティ - <パブリケーション]> の [行のフィルター選択] ページで、[フィルター選択されたテーブル] ペイン内のフィルターを選択し、[編集] をクリックします。
[結合の編集] ダイアログ ボックスで、フィルターを変更します。
[OK] を選択します。
結合フィルターを削除するには
- パブリケーションの新規作成ウィザードの [テーブル行のフィルター選択] ページ、または [パブリケーションのプロパティ - <パブリケーション]> の [行のフィルター選択] ページで、[フィルター選択されたテーブル] ペイン内のフィルターを選択し、[削除] をクリックします。 削除する結合フィルター自体が他の結合によって拡張されている場合は、それらの結合も削除されます。
Transact-SQL の使用
この手順では、親アーティクルのパラメーター化されたフィルターと、親アーティクルと子アーティクルの結合フィルターを組み合わせて使用する方法について説明します。 結合フィルターは、レプリケーションのストアド プロシージャを使用してプログラムから定義したり変更したりできます。
アーティクル フィルターをマージ パブリケーションの関連アーティクルに拡張する結合フィルターを定義するには
結合先アーティクル (親アーティクル) のフィルターを定義します。
パラメーター化された行フィルターを使ったアーティクルのフィルター選択については、「 マージ アーティクルのパラメーター化された行フィルターの定義および変更」を参照してください。
静的行フィルターを使ったアーティクルのフィルター選択については、「 Define and Modify a Static Row Filter」を参照してください。
パブリッシャーのパブリケーション データベースで sp_addmergearticle (Transact-SQL) を実行し、関連アーティクル (出版物の子アーティクル) を少なくとも 1 つ定義します。 詳しくは、「 アーティクルを定義」をご覧ください。
パブリッシャー側のパブリケーション データベースに対して、sp_addmergefilter (Transact-SQL) を実行します。
@publication
を指定し、@filtername
にはこのフィルターの一意の名前を、@article
には手順 2 で作成した子アーティクルの名前を、@join_articlename
には結合対象の親アーティクルの名前を指定し、@join_unique_key
に次のいずれかの値を指定します。0 - 親アーティクルと子アーティクル間の多対一または多対多の結合を示します。
1 - 親アーティクルと子アーティクル間の一対一または一対多の結合を示します。
これにより、2 つのアーティクル間の結合フィルターが定義されます。
注意事項
親アーティクルの基になるテーブルで、結合する列に一意性を保証する制約が割り当てられている場合にのみ、
@join_unique_key
を 1 に設定します。@join_unique_key
を 1 に正しく設定しなかった場合は、データの非収束が発生する可能性があります。
例 (Transact-SQL)
次の例では、マージ パブリケーションのアーティクルを定義しています。 SalesOrderDetail
テーブルのアーティクルが、 SalesOrderHeader
テーブルと比較されてフィルター選択されます (このテーブル自体が静的行フィルターを使ってフィルター選択されています)。 詳しくは、「 Define and Modify a Static Row Filter」をご覧ください。
DECLARE @publication AS sysname;
DECLARE @table1 AS sysname;
DECLARE @table2 AS sysname;
DECLARE @table3 AS sysname;
DECLARE @salesschema AS sysname;
DECLARE @hrschema AS sysname;
DECLARE @filterclause AS nvarchar(1000);
SET @publication = N'AdvWorksSalesOrdersMerge';
SET @table1 = N'Employee';
SET @table2 = N'SalesOrderHeader';
SET @table3 = N'SalesOrderDetail';
SET @salesschema = N'Sales';
SET @hrschema = N'HumanResources';
SET @filterclause = N'Employee.LoginID = HOST_NAME()';
-- Add a filtered article for the Employee table.
EXEC sp_addmergearticle
@publication = @publication,
@article = @table1,
@source_object = @table1,
@type = N'table',
@source_owner = @hrschema,
@schema_option = 0x0004CF1,
@description = N'article for the Employee table',
@subset_filterclause = @filterclause;
-- Add an article for the SalesOrderHeader table that is filtered
-- based on Employee and horizontally filtered.
EXEC sp_addmergearticle
@publication = @publication,
@article = @table2,
@source_object = @table2,
@type = N'table',
@source_owner = @salesschema,
@vertical_partition = N'true',
@schema_option = 0x0034EF1,
@description = N'article for the SalesOrderDetail table';
-- Add an article for the SalesOrderDetail table that is filtered
-- based on SaledOrderHeader.
EXEC sp_addmergearticle
@publication = @publication,
@article = @table3,
@source_object = @table3,
@source_owner = @salesschema,
@description = 'article for the SalesOrderHeader table',
@identityrangemanagementoption = N'auto',
@pub_identity_range = 100000,
@identity_range = 100,
@threshold = 80,
@schema_option = 0x0004EF1;
-- Add all columns to the SalesOrderHeader article.
EXEC sp_mergearticlecolumn
@publication = @publication,
@article = @table2,
@force_invalidate_snapshot = 1,
@force_reinit_subscription = 1;
-- Remove the credit card Approval Code column.
EXEC sp_mergearticlecolumn
@publication = @publication,
@article = @table2,
@column = N'CreditCardApprovalCode',
@operation = N'drop',
@force_invalidate_snapshot = 1,
@force_reinit_subscription = 1;
-- Add a merge join filter between Employee and SalesOrderHeader.
EXEC sp_addmergefilter
@publication = @publication,
@article = @table2,
@filtername = N'SalesOrderHeader_Employee',
@join_articlename = @table1,
@join_filterclause = N'Employee.BusinessEntityID = SalesOrderHeader.SalesPersonID',
@join_unique_key = 1,
@filter_type = 1,
@force_invalidate_snapshot = 1,
@force_reinit_subscription = 1;
-- Add a merge join filter between SalesOrderHeader and SalesOrderDetail.
EXEC sp_addmergefilter
@publication = @publication,
@article = @table3,
@filtername = N'SalesOrderDetail_SalesOrderHeader',
@join_articlename = @table2,
@join_filterclause = N'SalesOrderHeader.SalesOrderID = SalesOrderDetail.SalesOrderID',
@join_unique_key = 1,
@filter_type = 1,
@force_invalidate_snapshot = 1,
@force_reinit_subscription = 1;
GO
次の例では、マージ パブリケーションでアーティクル グループを定義しています。アーティクルは、 Employee
テーブルと比較されて、一連の結合フィルターを使ってフィルター選択されます (このテーブル自体が、 LoginID 列の HOST_NAME の値に対するパラメーター化された行フィルターを使ってフィルター選択されています)。 詳しくは、「 マージ アーティクルのパラメーター化された行フィルターの定義および変更」をご覧ください。
-- To avoid storing the login and password in the script file, the value
-- is passed into SQLCMD as a scripting variable. For information about
-- how to use scripting variables on the command line and in SQL Server
-- Management Studio, see the "Executing Replication Scripts" section in
-- the topic "Programming Replication Using System Stored Procedures".
--Add a new merge publication.
DECLARE @publicationdb AS sysname;
DECLARE @publication AS sysname;
DECLARE @table1 AS sysname;
DECLARE @table2 AS sysname;
DECLARE @filter AS sysname;
DECLARE @schema_hr AS sysname;
DECLARE @schema_sales AS sysname;
SET @publicationdb = N'AdventureWorks2022';
SET @publication = N'AdvWorksSalesPersonMerge';
SET @table1 = N'Employee';
SET @table2 = N'SalesPerson';
SET @filter = N'SalesPerson_Employee';
SET @schema_hr = N'HumanResources';
SET @schema_sales = N'Sales';
USE [AdventureWorks2022];
-- Enable AdventureWorks2022 for merge replication.
EXEC sp_replicationdboption
@dbname = @publicationdb,
@optname = N'merge publish',
@value = N'true';
-- Create new merge publication with Subscriber requested snapshot
-- and using the default agent schedule.
EXEC sp_addmergepublication
@publication = @publication,
@description = N'Merge publication of AdventureWorks2022.',
@allow_subscriber_initiated_snapshot = N'true',
@publication_compatibility_level = N'90RTM';
-- Create a new snapshot job for the publication, using the default schedule.
-- Pass credentials at runtime using sqlcmd scripting variables.
EXEC sp_addpublication_snapshot
@publication = @publication,
@job_login = $(login),
@job_password = $(password);
-- Add an article for the Employee table,
-- which is horizontally partitioned using
-- a parameterized row filter.
EXEC sp_addmergearticle
@publication = @publication,
@article = @table1,
@source_owner = @schema_hr,
@source_object = @table1,
@type = N'table',
@description = 'contains employee information',
@subset_filterclause = N'[LoginID] = HOST_NAME()';
-- Add an article for the SalesPerson table,
-- which is partitioned based on a join filter.
EXEC sp_addmergearticle
@publication = @publication,
@article = @table2,
@source_owner = @schema_sales,
@source_object = @table2,
@type = N'table',
@description = 'contains salesperson information';
-- Add a join filter between the two articles.
EXEC sp_addmergefilter
@publication = @publication,
@article = @table1,
@filtername = @filter,
@join_articlename = @table2,
@join_filterclause = N'[Employee].[BusinessEntityID] = [SalesPerson].[SalesPersonID]',
@join_unique_key = 1,
@filter_type = 1;
GO
-- Start the agent job to generate the full snapshot for the publication.
-- The filtered data snapshot is generated automatically the first time
-- the subscription is synchronized.
DECLARE @publication AS sysname;
SET @publication = N'AdvWorksSalesPersonMerge';
EXEC sp_startpublication_snapshot
@publication = @publication;
GO