定义和修改静态行筛选器

本主题说明如何使用 SQL Server Management Studio 或 Transact-SQL 在 SQL Server 2012 中定义和修改静态行筛选器。

本主题内容

  • 开始之前:

    限制和局限

    建议

  • 定义和修改静态行筛选器,使用:

    SQL Server Management Studio

    Transact-SQL

开始之前

限制和局限

  • 如果在初始化对发布的订阅后添加、修改或删除静态行筛选器,则必须在更改后生成新的快照并重新初始化所有订阅。 有关属性更改要求的详细信息,请参阅更改发布和项目属性

  • 如果为对等事务复制启用了发布,则不能筛选表。

建议

用于“返回首页”链接的箭头图标[Top]

使用 SQL Server Management Studio

可以在新建发布向导的**“筛选表行”页或“发布属性 - <发布>”对话框的“筛选行”**页上定义、修改和删除静态行筛选器。 有关使用该向导和访问该对话框的详细信息,请参阅创建发布查看和修改发布属性

定义静态行筛选器

  1. 在新建发布向导的**“筛选表行”页上或“发布属性 - <发布>”对话框的“筛选行”**页上,根据发布类型进行操作:

    • 对于快照发布或事务发布,请单击**“添加”**。

    • 对于合并发布,请单击**“添加”,再单击“添加筛选器”**。

  2. 在**“添加筛选器”**对话框中,从下拉列表框中选择要筛选的表。

  3. 在**“筛选语句”文本区域创建筛选语句。 您可以在文本区域中直接键入,也可以从“列”**列表框中拖放列。

    注意注意

    WHERE 子句应使用由两部分构成的命名方式,不支持由三部分和四部分构成的命名方式。 如果发布来自 Oracle 发布服务器,则 WHERE 子句必须符合 Oracle 语法。

    • **“筛选语句”**文本区域包括默认的文本,其格式为:

      SELECT <published_columns> FROM [schema].[tablename] WHERE
      
    • 默认文本无法更改;请使用标准的 SQL 语法在 WHERE 关键字后键入筛选子句。 完整筛选子句如下所示:

      SELECT <published_columns> FROM [HumanResources].[Employee] WHERE [LoginID] = 'adventure-works\ranjit0'
      
    • 静态行筛选器可以包含用户定义函数。 包含用户定义函数的静态行筛选器的完整筛选子句如下所示:

      SELECT <published_columns> FROM [Sales].[SalesOrderHeader] WHERE MyFunction([Freight]) > 100
      
  4. 单击“确定”。

  5. 如果在**“发布属性 - <发布>”对话框中,请单击“确定”**保存并关闭对话框。

修改静态行筛选器

  1. 在新建发布向导的**“筛选表行”页上或“发布属性 - <发布>”对话框的“筛选行”页上的“筛选的表”窗格中选择筛选器,再单击“编辑”**。

  2. 在**“编辑筛选器”**对话框中,修改筛选器。

  3. 单击“确定”。

删除静态行筛选器

  • 在新建发布向导的**“筛选表行”页上或“发布属性 - <发布>”对话框的“筛选行”页上的“筛选的表”窗格中选择筛选器,再单击“删除”**。

用于“返回首页”链接的箭头图标[Top]

使用 Transact-SQL

在创建表项目时,可以定义 WHERE 子句以筛选项目中的行。 定义行筛选器后,还可以对其进行更改。 可使用复制存储过程以编程的方式创建和修改静态行筛选器。

为快照发布或事务发布定义静态行筛选器

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

  2. 在发布服务器上,对发布数据库执行 sp_articlefilter (Transact-SQL)。 为 @article 指定项目的名称,为 @publication 指定发布的名称,为 @filter_name 指定筛选器的名称,并为 @filter_clause 指定筛选子句(不包括 WHERE)。

  3. 如果还必须定义列筛选器,请参阅定义和修改列筛选器。 否则,执行 sp_articleview (Transact-SQL)。 为 @publication 指定发布名称,为 @article 指定筛选项目的名称,为 @filter_clause 指定步骤 2 中指定的筛选子句。 这将为筛选的项目创建同步对象。

为快照发布或事务发布修改静态行筛选器

  1. 在发布服务器上,对发布数据库执行 sp_articlefilter (Transact-SQL)。 为 @article 指定项目的名称,为 @publication 指定发布的名称,为 @filter_name 指定新筛选器的名称,并为 @filter_clause 指定新筛选子句(不包括 WHERE)。 由于此更改将使现有订阅中的数据失效,因此请将 @force_reinit_subscription 的值指定为 1

  2. 在发布服务器上,对发布数据库执行 sp_articleview (Transact-SQL)。 为 @publication 指定发布名称,为 @article 指定筛选项目的名称,为 @filter_clause 指定步骤 1 中指定的筛选子句。 这将重新创建定义筛选项目的视图。

  3. 对发布重新运行快照代理作业以生成更新的快照。 有关详细信息,请参阅创建并应用初始快照

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

为快照发布或事务发布删除静态行筛选器

  1. 在发布服务器上,对发布数据库执行 sp_articlefilter (Transact-SQL)。 为 @article 指定项目的名称,为 @publication 指定发布的名称,将 @filter_name 的值指定为 NULL,并将 @filter_clause 的值指定为 NULL。 由于此更改将使现有订阅中的数据失效,因此请将 @force_reinit_subscription 的值指定为 1

  2. 对发布重新运行快照代理作业以生成更新的快照。 有关详细信息,请参阅创建并应用初始快照

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

为合并发布定义静态行筛选器

  1. 在发布服务器上,对发布数据库执行 sp_addmergearticle (Transact-SQL)。 为 @subset_filterclause 指定筛选子句(不包括 WHERE)。 有关详细信息,请参阅定义项目

  2. 如果还必须定义列筛选器,请参阅定义和修改列筛选器

为合并发布修改静态行筛选器

  1. 在发布服务器上,对发布数据库执行 sp_changemergearticle (Transact-SQL)。 为 @publication 指定发布名称,为 @article 指定筛选项目的名称,为 @property 指定 subset_filterclause 值,并为 @value 指定新筛选子句(不包括 WHERE)。 由于此更改将使现有订阅中的数据失效,因此请将 @force_reinit_subscription 的值指定为 1。

  2. 对发布重新运行快照代理作业以生成更新的快照。 有关详细信息,请参阅创建并应用初始快照

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

示例 (Transact-SQL)

在此事务复制示例中,对项目进行水平筛选以删除所有停产的产品。

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

在此合并复制示例中,对项目进行水平筛选以仅返回属于指定销售人员的行。 其中还使用了联接筛选器。 有关详细信息,请参阅定义和修改合并项目间的联接筛选器

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]

请参阅

概念

定义和修改合并项目的参数化行筛选器

更改发布和项目属性

筛选已发布数据

为合并复制筛选已发布数据