定义和修改列筛选器

  • 项目

本主题介绍如何使用 SQL Server Management Studio 或 Transact-SQL 在 SQL Server 2014 中定义和修改列筛选器。

本主题内容

开始之前

限制和局限

  • 某些列无法筛选；有关详细信息，请参阅筛选已发布数据。 如果在初始化订阅之后修改了列筛选器，则必须在更改后生成新的快照并重新初始化所有订阅。 有关属性更改要求的详细信息，请参阅更改发布和项目属性。

使用 SQL Server Management Studio

可以在新建发布向导的 “项目” 页上定义列筛选器。 有关使用新建发布向导的详细信息，请参阅创建发布。

在“发布属性 - <>发布”对话框的“项目”页上定义和修改列筛选器。 有关发布和项目属性的详细信息，请参阅查看和修改发布属性。

定义列筛选器

  1. 在新建发布向导的 “项目” 页上，在 “要发布的对象” 窗格中展开要筛选的表。

  2. 清除要筛选的每个列旁边的复选框。

修改列筛选

  1. 在“发布属性 - <发布>”对话框的“项目”页上，展开“要发布的对象”窗格中要筛选的表。

  2. 清除要筛选的每个列旁边的复选框，并确保选中每个应包含在项目中的列的复选框。

  3. 单击 “确定” 。

“使用 Transact-SQL”

在创建表项目时，您可以定义要在项目中包含的列以及在定义项目后更改列。 您可以使用复制存储过程以编程的方式创建和修改已筛选的列。

注意

下列过程假定基础表未发生更改。 有关将数据定义语言 (DDL) 更改复制到已发布表的信息，请参阅对发布数据库进行架构更改。

为快照发布或事务发布中发布的项目定义列筛选器

  1. 定义要筛选的项目。 有关详细信息，请参阅 定义项目。

  2. 在发布服务器的发布数据库中，执行 sp_articlecolumn。 这将定义要包括在项目中或要从项目中删除的列。

    • 如果仅发布拥有许多列的表中的几个列，请对要添加的每个列执行一次 sp_articlecolumn 。 为 @column 指定列名，为 @operation 指定 add 值。

    • 如果在包含多个列的表中发布大多数列，请执行sp_articlecolumn，为 @column 指定 null 值，为 @operation 指定 add 值以添加所有列。 然后，对要排除的每个列执行一次sp_articlecolumn，为@operation指定一个 drop 值，为@column指定排除的列名称。

  3. 在发布服务器的发布数据库中，执行 sp_articleview。 指定 @publication 的发布名称和 @article筛选项目的名称。 这将为筛选的项目创建同步对象。

为快照发布或事务发布中发布的项目更改列筛选器以包括其他列

  1. 在发布服务器的发布数据库中，对要添加的每个列执行一次 sp_articlecolumn 。 为 @column 指定列名，为 @operation 指定 add 值。

  2. 在发布服务器的发布数据库中，执行 sp_articleview。 指定 @publication 的发布名称和 @article筛选项目的名称。 如果发布具有现有订阅，请为@change_active指定值 1。 这将为已筛选的项目重新创建同步对象。

  3. 对发布重新运行快照代理作业以生成更新的快照。

  4. 重新初始化订阅。 有关详细信息，请参阅 重新初始化订阅。

为快照发布或事务发布中发布的项目更改列筛选器以删除列

  1. 在发布服务器的发布数据库中，对要删除的每个列执行一次 sp_articlecolumn 。 为 @column 指定列名，为 @operation 指定 drop 值。

  2. 在发布服务器的发布数据库中，执行 sp_articleview。 指定 @publication 的发布名称和 @article筛选项目的名称。 如果发布具有现有订阅，请为@change_active指定值 1。 这将为已筛选的项目重新创建同步对象。

  3. 对发布重新运行快照代理作业以生成更新的快照。

  4. 重新初始化订阅。 有关详细信息，请参阅 重新初始化订阅。

为合并复制中发布的项目定义列筛选器

  1. 定义要筛选的项目。 有关详细信息，请参阅 定义项目。

  2. 在发布服务器的发布数据库中，执行 sp_mergearticlecolumn。 这将定义要包括在项目中或要从项目中删除的列。

    • 如果仅发布拥有许多列的表中的几个列，请对要添加的每个列执行一次 sp_mergearticlecolumn 。 为 @column 指定列名，为 @operation 指定 add 值。

    • 如果在包含多个列的表中发布大多数列，请执行sp_mergearticlecolumn，将 @column 的值指定为 null，为 @operation 指定 add 值以添加所有列。 然后，对要排除的每个列执行一次sp_mergearticlecolumn，为@operation指定 drop 值，为@column指定排除的列名称。

为合并发布中发布的项目更改列筛选器以包括其他列

  1. 在发布服务器的发布数据库中，对要添加的每个列执行一次 sp_mergearticlecolumn 。 为 @column 指定列名，为 @operation 指定 add 值，为 @force_invalidate_snapshot 和 @force_reinit_subscription 指定值 1。

  2. 对发布重新运行快照代理作业以生成更新的快照。

  3. 重新初始化订阅。 有关详细信息，请参阅 重新初始化订阅。

为合并发布中发布的项目更改列筛选器以删除列

  1. 在发布服务器的发布数据库中，对要删除的每个列执行一次 sp_mergearticlecolumn 。 为 @column 指定列名，为 @operation 指定值 drop，为 @force_invalidate_snapshot 和 @force_reinit_subscription 指定值 1。

  2. 对发布重新运行快照代理作业以生成更新的快照。

  3. 重新初始化订阅。 有关详细信息，请参阅 重新初始化订阅。

示例 (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

另请参阅

更改发布和项目属性
筛选已发布数据
为合并复制筛选已发布数据