列フィルターの定義および変更
適用対象: SQL Server Azure SQL Managed Instance
このトピックでは、SQL Server で、SQL Server Management Studio または Transact-SQL を使用して、列フィルターを定義して変更する方法について説明します。
このトピックの内容
作業を開始する準備:
列フィルターを定義または変更するために使用するもの:
はじめに
制限事項と制約事項
- 一部の列はフィルター選択できません。詳細については、「Filter Published Data」(パブリッシュされたデータのフィルター処理) をご覧ください。 サブスクリプションを初期化した後で列フィルターを変更する場合には、列フィルターの変更後、新規スナップショットを生成してすべてのサブスクリプションを再初期化する必要があります。 プロパティ変更の要件の詳細については、「Change Publication and Article Properties」(パブリケーションとアーティクルのプロパティの変更) をご覧ください。
SQL Server Management Studio を使用する
パブリケーションの新規作成ウィザードの [アーティクル] ページで列フィルターを定義します。 パブリケーションの新規作成ウィザードの詳細については、「Create a Publication」(パブリケーションの作成) をご覧ください。
[パブリケーションのプロパティ - <パブリケーション]> ダイアログ ドロップダウン リストの [アーティクル] ページで列フィルターの定義および変更を行います。 パブリケーションとアーティクルのプロパティの詳細については、「View and Modify Publication Properties」(パブリケーション プロパティの表示と変更) をご覧ください。
列フィルターを定義するには
パブリケーションの新規作成ウィザードの [アーティクル] ページにある [パブリッシュするオブジェクト] ペインで、フィルター選択するテーブルを展開します。
フィルター選択する列の隣にあるチェック ボックスをオフにします。
列フィルターを変更するには
[パブリケーションのプロパティ - <パブリケーション]> ダイアログ ドロップダウン リストの [アーティクル] ページにある [パブリッシュするオブジェクト] ペインで、フィルター選択するテーブルを展開します。
フィルター選択する列の隣にあるチェック ボックスをオフにして、アーティクルに含める列のチェック ボックスをオンにします。
[OK] を選択します。
Transact-SQL の使用
テーブル アーティクルを作成するときに、アーティクルにどの列を含めるかを定義したり、アーティクルを定義した後で列を変更したりできます。 レプリケーション ストアド プロシージャを使用して、フィルターが適用された列をプログラムで作成および変更できます。
Note
次の手順は、基になるテーブルが変更されていないことが前提となっています。 パブリッシュされたテーブルにデータ定義言語 (DDL) の変更をレプリケートする方法の詳細については、「Make Schema Changes on Publication Databases」(パブリケーション データベースでのスキーマの変更) をご覧ください。
スナップショット パブリケーションまたはトランザクション パブリケーションでパブリッシュされたアーティクルの列フィルターを定義するには
フィルターを適用するアーティクルを定義します。 詳しくは、「 アーティクルを定義」をご覧ください。
パブリッシャー側のパブリケーション データベースで、 sp_articlecolumnを実行します。 これにより、アーティクルに含める列、またはアーティクルから削除する列を定義します。
多数の列を含むテーブルから少数の列をパブリッシュする場合は、追加する各列に対して sp_articlecolumn を一度実行します。 @column に列名を指定し、 @operation に addを指定します。
多数の列を含むテーブルの列の大半をパブリッシュする場合は、 sp_articlecolumnを実行します。その場合、 @column に null を指定し、 @operation に add を指定してすべての列を追加します。 次に、除外する各列に sp_articlecolumnを一度ずつ実行します。その場合、 @operation に drop を指定し、 @columnに除外する列名を指定します。
パブリッシャー側のパブリケーション データベースで、 sp_articleviewを実行します。 @publication にパブリケーション名を指定し、 @articleにフィルターを適用するアーティクルの名前を指定します。 これにより、フィルターを適用するアーティクルの同期オブジェクトが作成されます。
スナップショット パブリケーションまたはトランザクション パブリケーションでパブリッシュされたアーティクルに対して、追加列を含めるための列フィルターを定義するには
パブリッシャー側のパブリケーション データベースで、追加する各列に対して sp_articlecolumn を一度ずつ実行します。 @column に列名を指定し、 @operation に addを指定します。
パブリッシャー側のパブリケーション データベースで、 sp_articleviewを実行します。 @publication にパブリケーション名を指定し、 @articleにフィルターを適用するアーティクルの名前を指定します。 パブリケーションに既存のサブスクリプションが存在する場合は、 @change_active に 1を指定します。 これにより、フィルターを適用するアーティクルの同期オブジェクトが再作成されます。
パブリケーションに対してスナップショット エージェント ジョブを再実行し、更新済みスナップショットを生成します。
サブスクリプションを再初期化します。 詳細については、「 サブスクリプションの再初期化」を参照してください。
スナップショット パブリケーションまたはトランザクション パブリケーションでパブリッシュされたアーティクルに対して、列を削除するための列フィルターを定義するには
パブリッシャー側のパブリケーション データベースで、削除する各列に対して sp_articlecolumn を一度実行します。 @column に列名を指定し、 @operation に dropを指定します。
パブリッシャー側のパブリケーション データベースで、 sp_articleviewを実行します。 @publication にパブリケーション名を指定し、 @articleにフィルターを適用するアーティクルの名前を指定します。 パブリケーションに既存のサブスクリプションが存在する場合は、 @change_active に 1を指定します。 これにより、フィルターを適用するアーティクルの同期オブジェクトが再作成されます。
パブリケーションに対してスナップショット エージェント ジョブを再実行し、更新済みスナップショットを生成します。
サブスクリプションを再初期化します。 詳細については、「 サブスクリプションの再初期化」を参照してください。
スナップショットまたはマージ パブリケーションでパブリッシュされたアーティクルの列フィルターを定義するには
フィルターを適用するアーティクルを定義します。 詳しくは、「 アーティクルを定義」をご覧ください。
パブリッシャー側のパブリケーション データベースで、 sp_mergearticlecolumnを実行します。 これにより、アーティクルに含める列、またはアーティクルから削除する列を定義します。
多数の列を含むテーブルから少数の列のみをパブリッシュする場合は、追加する各列に対して sp_mergearticlecolumn を一度ずつ実行します。 @column に列名を指定し、 @operation に addを指定します。
多数の列を含むテーブルの大半の列をパブリッシュする場合は、 sp_mergearticlecolumnを実行します。この場合、 @column に null を指定し、 @operation に add を指定してすべての列を追加します。 次に、除外する各列に対して sp_mergearticlecolumnを一度ずつ実行します。この場合、 @operation に drop を指定し、 @columnに除外する列名を指定します。
マージ パブリケーションでパブリッシュされたアーティクルに対して、追加列を含めるための列フィルターを定義するには
パブリッシャー側のパブリケーション データベースで、追加する各列に対して sp_mergearticlecolumn を一度ずつ実行します。 @columnに列名を、 @operation に add 、 @force_invalidate_snapshot と @force_reinit_subscription の両方に 1を指定します。
パブリケーションに対してスナップショット エージェント ジョブを再実行し、更新済みスナップショットを生成します。
サブスクリプションを再初期化します。 詳細については、「 サブスクリプションの再初期化」を参照してください。
マージ パブリケーションでパブリッシュされたアーティクルに対して、列を削除するための列フィルターを変更するには
パブリッシャー側のパブリケーション データベースで、削除する各列に対して sp_mergearticlecolumn を一度ずつ実行します。 @columnに列名を、 @operation に drop を、 @force_invalidate_snapshot と @force_reinit_subscription の両方に 1を指定します。
パブリケーションに対してスナップショット エージェント ジョブを再実行し、更新済みスナップショットを生成します。
サブスクリプションを再初期化します。 詳細については、「 サブスクリプションの再初期化」を参照してください。
例 (Transact-SQL)
次のトランザクション レプリケーション例では、 DaysToManufacture
テーブルに基づく Product
列がアーティクルから削除されます。
DECLARE @publication AS sysname;
DECLARE @table AS sysname;
DECLARE @filterclause AS nvarchar(500);
DECLARE @filtername AS nvarchar(386);
DECLARE @schemaowner AS sysname;
SET @publication = N'AdvWorksProductTran';
SET @table = N'Product';
SET @filterclause = N'[DiscontinuedDate] IS NULL';
SET @filtername = N'filter_out_discontinued';
SET @schemaowner = N'Production';
-- Add a horizontally and vertically filtered article for the Product table.
-- Manually set @schema_option to ensure that the Production schema
-- is generated at the Subscriber (0x8000000).
EXEC sp_addarticle
@publication = @publication,
@article = @table,
@source_object = @table,
@source_owner = @schemaowner,
@schema_option = 0x80030F3,
@vertical_partition = N'true',
@type = N'logbased',
@filter_clause = @filterclause;
-- (Optional) Manually call the stored procedure to create the
-- horizontal filtering stored procedure. Since the type is
-- 'logbased', this stored procedures is executed automatically.
EXEC sp_articlefilter
@publication = @publication,
@article = @table,
@filter_clause = @filterclause,
@filter_name = @filtername;
-- Add all columns to the article.
EXEC sp_articlecolumn
@publication = @publication,
@article = @table;
-- Remove the DaysToManufacture column from the article
EXEC sp_articlecolumn
@publication = @publication,
@article = @table,
@column = N'DaysToManufacture',
@operation = N'drop';
-- (Optional) Manually call the stored procedure to create the
-- vertical filtering view. Since the type is 'logbased',
-- this stored procedures is executed automatically.
EXEC sp_articleview
@publication = @publication,
@article = @table,
@filter_clause = @filterclause;
GO
次のマージ レプリケーション例では、 CreditCardApprovalCode
テーブルに基づく 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
参照
パブリケーションおよびアーティクルのプロパティの変更
パブリッシュされたデータのフィルター選択
マージ レプリケーション用にパブリッシュされたデータのフィルター選択