列フィルターの定義および変更

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

このトピックでは、SQL Server 2012 で SQL Server Management Studio または Transact-SQL を使用して、列フィルターを定義および変更する方法について説明します。

このトピックの内容

作業を開始する準備:

制限事項と制約事項
列フィルターを定義または変更するために使用するもの:

SQL Server Management Studio

Transact-SQL

作業を開始する準備

制限事項と制約事項

一部の列はフィルター選択できません。詳細については、「パブリッシュされたデータのフィルター選択」を参照してください。サブスクリプションを初期化した後で列フィルターを変更する場合には、列フィルターの変更後、新規スナップショットを生成してすべてのサブスクリプションを再初期化する必要があります。プロパティ変更の要件の詳細については、「パブリケーションおよびアーティクルのプロパティの変更」を参照してください。

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

SQL Server Management Studio の使用

パブリケーションの新規作成ウィザードの [アーティクル] ページで列フィルターを定義します。パブリケーションの新規作成ウィザードの詳細については、「パブリケーションの作成」を参照してください。

[パブリケーションのプロパティ - <Publication>] ダイアログボックスの [アーティクル] ページで列フィルターの定義および変更を行います。パブリケーションおよびアーティクルのプロパティの詳細については、「パブリケーションプロパティの表示および変更」を参照してください。

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

パブリケーションの新規作成ウィザードの [アーティクル] ページにある [パブリッシュするオブジェクト] ペインで、フィルター選択するテーブルを展開します。
フィルター選択する列の隣にあるチェックボックスをオフにします。

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

[パブリケーションのプロパティ - <Publication>] ダイアログボックスの [アーティクル] ページにある [パブリッシュするオブジェクト] ペインで、フィルター選択するテーブルを展開します。
フィルター選択する列の隣にあるチェックボックスをオフにして、アーティクルに含める列のチェックボックスをオンにします。
[OK] をクリックします。

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

Transact-SQL の使用

テーブルアーティクルを作成するときに、アーティクルにどの列を含めるかを定義したり、アーティクルを定義した後で列を変更したりできます。レプリケーションストアドプロシージャを使用して、フィルターが適用された列をプログラムで作成および変更できます。

注
次の手順は、基になるテーブルが変更されていないことが前提となっています。パブリッシュされたテーブルにデータ定義言語 (DDL) の変更をレプリケートする方法の詳細については、「パブリケーションデータベースでのスキーマの変更」を参照してください。

スナップショットパブリケーションまたはトランザクションパブリケーションでパブリッシュされたアーティクルの列フィルターを定義するには

フィルターを適用するアーティクルを定義します。詳細については、「アーティクルの定義」を参照してください。
パブリッシャー側のパブリケーションデータベースで、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)

次のトランザクションレプリケーション例では、Product テーブルに基づく DaysToManufacture 列がアーティクルから削除されます。

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

次のマージレプリケーション例では、SalesOrderHeader テーブルに基づく CreditCardApprovalCode 列がアーティクルから削除されます。

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

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

次の方法で共有

列フィルターの定義および変更

作業を開始する準備

制限事項と制約事項

SQL Server Management Studio の使用

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

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

Transact-SQL の使用

スナップショットパブリケーションまたはトランザクションパブリケーションでパブリッシュされたアーティクルの列フィルターを定義するには

スナップショットパブリケーションまたはトランザクションパブリケーションでパブリッシュされたアーティクルに対して、追加列を含めるための列フィルターを定義するには

スナップショットパブリケーションまたはトランザクションパブリケーションでパブリッシュされたアーティクルに対して、列を削除するための列フィルターを定義するには

スナップショットまたはマージパブリケーションでパブリッシュされたアーティクルの列フィルターを定義するには

マージパブリケーションでパブリッシュされたアーティクルに対して、追加列を含めるための列フィルターを定義するには

マージパブリケーションでパブリッシュされたアーティクルに対して、列を削除するための列フィルターを変更するには

例 (Transact-SQL)

関連項目

概念

その他のリソース

次の方法で共有

列フィルターの定義および変更

作業を開始する準備

制限事項と制約事項

SQL Server Management Studio の使用

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

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

Transact-SQL の使用

スナップショット パブリケーションまたはトランザクション パブリケーションでパブリッシュされたアーティクルの列フィルターを定義するには

スナップショット パブリケーションまたはトランザクション パブリケーションでパブリッシュされたアーティクルに対して、追加列を含めるための列フィルターを定義するには

スナップショット パブリケーションまたはトランザクション パブリケーションでパブリッシュされたアーティクルに対して、列を削除するための列フィルターを定義するには

スナップショットまたはマージ パブリケーションでパブリッシュされたアーティクルの列フィルターを定義するには

マージ パブリケーションでパブリッシュされたアーティクルに対して、追加列を含めるための列フィルターを定義するには

マージ パブリケーションでパブリッシュされたアーティクルに対して、列を削除するための列フィルターを変更するには

例 (Transact-SQL)

関連項目

概念

その他のリソース

スナップショットパブリケーションまたはトランザクションパブリケーションでパブリッシュされたアーティクルの列フィルターを定義するには

スナップショットパブリケーションまたはトランザクションパブリケーションでパブリッシュされたアーティクルに対して、追加列を含めるための列フィルターを定義するには

スナップショットパブリケーションまたはトランザクションパブリケーションでパブリッシュされたアーティクルに対して、列を削除するための列フィルターを定義するには

スナップショットまたはマージパブリケーションでパブリッシュされたアーティクルの列フィルターを定義するには

マージパブリケーションでパブリッシュされたアーティクルに対して、追加列を含めるための列フィルターを定義するには

マージパブリケーションでパブリッシュされたアーティクルに対して、列を削除するための列フィルターを変更するには