マージアーティクル間の結合フィルターの定義および変更

[アーティクル]
06/18/2013

このトピックでは、SQL Server 2012 で SQL Server Management Studio または Transact-SQL を使用して、マージアーティクル間の結合フィルターを定義および変更する方法について説明します。マージレプリケーションでは結合フィルターがサポートされています。結合フィルターは、通常、テーブル分割を他の関連するテーブルアーティクルに拡張するために、パラメーター化されたフィルターと組み合わせて使用されます。

このトピックの内容

作業を開始する準備:

制限事項と制約事項

推奨事項
マージアーティクル間の結合フィルターを定義および変更するために使用するもの:

SQL Server Management Studio

Transact-SQL

作業を開始する準備

制限事項と制約事項

結合フィルターを作成するには、パブリケーションに少なくとも 2 つの関連テーブルを含める必要があります。結合フィルターは、行フィルターを拡張したものです。そのため、結合を使用して行フィルターを別のテーブルに拡張するには、先に 1 つのテーブルの行フィルターを定義する必要があります。結合フィルターを 1 つ定義すると、パブリケーションに追加の関連テーブルが含まれている場合、この結合フィルターは別の結合フィルターを使用して拡張できます。
パブリケーションに対するサブスクリプションが初期化された後に、結合フィルターを追加、変更、または削除した場合は、変更を行った後で、新しいスナップショットを生成し、すべてのサブスクリプションを再初期化する必要があります。プロパティ変更の要件の詳細については、「パブリケーションおよびアーティクルのプロパティの変更」を参照してください。

推奨事項

結合フィルターは、一連のテーブルに対して手動で作成できます。また、テーブルに定義された外部キーと主キーのリレーションシップに基づいて、レプリケーションによって自動的に生成することもできます。一連の結合フィルターを自動的に生成する方法の詳細については、「マージアーティクル間の一連の結合フィルターを自動的に生成する (SQL Server Management Studio)」を参照してください。

[トップに戻る] リンクで使用される矢印アイコン [Top]

SQL Server Management Studio の使用

パブリケーションの新規作成ウィザードの [テーブル行のフィルター選択] ページまたは [パブリケーションのプロパティ - <Publication>] ダイアログボックスの [行のフィルター選択] ページで、結合フィルターを定義、変更、または削除します。このウィザードの使用とダイアログボックスへのアクセスの詳細については、「パブリケーションの作成」および「パブリケーションプロパティの表示および変更」を参照してください。

結合フィルターを定義するには

パブリケーションの新規作成ウィザードの [テーブル行のフィルター選択] ページ、または [パブリッシャーのプロパティ - <Publication>] の [行のフィルター選択] ページで、[フィルター選択されたテーブル] ペイン内の既存の行フィルターまたは結合フィルターを選択します。
[追加] をクリックし、[選択したフィルターを拡張するために結合を追加する] をクリックします。
JOIN ステートメントを作成します。[ビルダーを使用してステートメントを作成する] または [JOIN ステートメントを手動で作成する] を選択します。
- ビルダーを使用するように選択した場合は、グリッド内の列 ([結合]、[フィルター選択されたテーブルの列]、[演算子]、および [結合テーブル列]) を使用して、JOIN ステートメントを作成します。
  
  グリッド内の各列にはドロップダウンコンボボックスがあり、これを使用して 2 つの列と演算子 ([=]、[<>]、[<=]、[<]、[>=]、[>]、および [like]) を選択できます。結果は [プレビュー] テキスト領域に表示されます。結合に列のペアを複数個含める場合は、[結合] 列から結合 (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 以降のバージョンのみ)。このオプションは、論理レコードを使用するためのアーティクルとパブリケーションの必要条件が満たされた場合にのみ、使用できます。詳細については、「論理レコードによる関連行への変更のグループ化」の「論理レコードの使用についての注意点」を参照してください。

[OK] をクリックします。
[パブリケーションのプロパティ - <Publication>] ダイアログボックスが表示されている場合は、[OK] をクリックして保存し、ダイアログボックスを閉じます。

結合フィルターを変更するには

パブリケーションの新規作成ウィザードの [テーブル行のフィルター選択] ページ、または [パブリケーションのプロパティ - <Publication>] の [行のフィルター選択] ページで、[フィルター選択されたテーブル] ペイン内のフィルターを選択し、[編集] をクリックします。
[結合の編集] ダイアログボックスで、フィルターを変更します。
[OK] をクリックします。

結合フィルターを削除するには

パブリケーションの新規作成ウィザードの [テーブル行のフィルター選択] ページ、または [パブリケーションのプロパティ - <Publication>] の [行のフィルター選択] ページで、[フィルター選択されたテーブル] ペイン内のフィルターを選択し、[削除] をクリックします。削除する結合フィルター自体が他の結合によって拡張されている場合は、それらの結合も削除されます。

[トップに戻る] リンクで使用される矢印アイコン [Top]

Transact-SQL の使用

この手順では、親アーティクルのパラメーター化されたフィルターと、親アーティクルと子アーティクルの結合フィルターを組み合わせて使用する方法について説明します。結合フィルターは、レプリケーションのストアドプロシージャを使用してプログラムから定義したり変更したりできます。

アーティクルフィルターをマージパブリケーションの関連アーティクルに拡張する結合フィルターを定義するには

結合先アーティクル (親アーティクル) のフィルターを定義します。
- パラメーター化された行フィルターを使ったアーティクルのフィルター選択については、「マージアーティクルのパラメーター化された行フィルターの定義および変更」を参照してください。
- 静的行フィルターを使ったアーティクルのフィルター選択については、「静的行フィルターの定義および変更」を参照してください。
パブリッシャーのパブリケーションデータベースで sp_addmergearticle (Transact-SQL) を実行し、関連アーティクル (パブリケーションの子アーティクル) を少なくとも 1 つ定義します。詳細については、「アーティクルの定義」を参照してください。

パブリッシャー側のパブリケーションデータベースに対して、sp_addmergefilter (Transact-SQL) を実行します。 @publication を指定し、@filtername、@article、@join_articlename に、それぞれ、このフィルターの一意の名前、手順 2. で作成した子アーティクルの名前、結合対象の親アーティクルの名前を指定し、さらに、次のいずれかの値を @join_unique_key に指定します。

0 - 親アーティクルと子アーティクル間の多対一または多対多の結合を示します。
1 - 親アーティクルと子アーティクル間の一対一または一対多の結合を示します。

これにより、2 つのアーティクル間の結合フィルターが定義されます。

注意
親アーティクルの基になるテーブルで、結合する列に一意性を保証する制約が割り当てられている場合にのみ、@join_unique_key を 1 に設定します。 @join_unique_key を 1 に正しく設定しなかった場合は、データが収束しなくなる可能性があります。

例 (Transact-SQL)

次の例では、マージパブリケーションのアーティクルを定義しています。SalesOrderDetail テーブルのアーティクルが、SalesOrderHeader テーブルと比較されてフィルター選択されます (このテーブル自体が静的行フィルターを使ってフィルター選択されています)。詳細については、「静的行フィルターの定義および変更」を参照してください。

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'AdventureWorks2012';
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 [AdventureWorks2012];

-- Enable AdventureWorks2012 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 AdventureWorks2012.', 
  @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

[トップに戻る] リンクで使用される矢印アイコン [Top]

次の方法で共有

マージアーティクル間の結合フィルターの定義および変更

作業を開始する準備

制限事項と制約事項

推奨事項

SQL Server Management Studio の使用

結合フィルターを定義するには

結合フィルターを変更するには

結合フィルターを削除するには

Transact-SQL の使用

アーティクルフィルターをマージパブリケーションの関連アーティクルに拡張する結合フィルターを定義するには

例 (Transact-SQL)

関連項目

概念

その他のリソース

次の方法で共有

マージ アーティクル間の結合フィルターの定義および変更

作業を開始する準備

制限事項と制約事項

推奨事項

SQL Server Management Studio の使用

結合フィルターを定義するには

結合フィルターを変更するには

結合フィルターを削除するには

Transact-SQL の使用

アーティクル フィルターをマージ パブリケーションの関連アーティクルに拡張する結合フィルターを定義するには

例 (Transact-SQL)

関連項目

概念

その他のリソース

マージアーティクル間の結合フィルターの定義および変更

アーティクルフィルターをマージパブリケーションの関連アーティクルに拡張する結合フィルターを定義するには