定义和修改静态行筛选器
本主题介绍如何使用 SQL Server Management Studio 或 Transact-SQL 在 SQL Server 中定义和修改静态行筛选器。
本主题内容
开始之前:
定义和修改静态行筛选器,使用:
开始之前
限制和局限
如果在初始化对发布的订阅后添加、修改或删除静态行筛选器,则必须在更改后生成新的快照并重新初始化所有订阅。 有关属性更改要求的详细信息,请参阅更改发布和项目属性。
如果为对等事务复制启用了发布,则不能筛选表。
建议
- 由于这些筛选器是静态的,因此所有订阅服务器都将接收到相同的数据子集。 如果您需要在属于合并发布的表项目中动态筛选行,以使每一订阅服务器都能接收到不同的数据分区,请参阅 定义和修改合并项目的参数化行筛选器。 您还可使用合并复制基于现有的行筛选器筛选相关的行。 有关详细信息,请参阅 定义和修改合并项目间的联接筛选器。
使用 SQL Server Management Studio
可在新建发布向导的“筛选表行”页或“发布属性 - <发布>”对话框的“筛选行”页上定义、修改和删除静态行筛选器。 有关如何使用该向导和如何访问该对话框的详细信息,请参阅创建发布和查看和修改发布属性。
定义静态行筛选器
在新建发布向导的“筛选表行”页或“发布属性 - <发布>”对话框的“筛选行”页上,执行的操作取决于发布类型:
对于快照发布或事务发布,请单击 “添加”。
对于合并发布,请单击 “添加”,再单击 “添加筛选器”。
在 “添加筛选器” 对话框中,从下拉列表框中选择要筛选的表。
在 “筛选语句” 文本区域创建筛选语句。 您可以在文本区域中直接键入,也可以从 “列” 列表框中拖放列。
注意
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
选择“确定”。
如果处于“发布属性 - <发布>”对话框中,请单击“确定”以保存并关闭该对话框。
修改静态行筛选器
在新建发布向导的“筛选表行”页或“发布属性 - <发布>”对话框的“筛选行”页上,在“筛选的表”窗格中选择筛选器,然后单击“编辑”。
在 “编辑筛选器” 对话框中,修改筛选器。
选择“确定”。
删除静态行筛选器
- 在新建发布向导的“筛选表行”页或“发布属性 - <发布>”对话框的“筛选行”页上,在“筛选的表”窗格中选择筛选器,然后单击“删除”。
“使用 Transact-SQL”
在创建表项目时,可以定义 WHERE 子句以筛选项目中的行。 定义行筛选器后,还可以对其进行更改。 可使用复制存储过程以编程的方式创建和修改静态行筛选器。
为快照发布或事务发布定义静态行筛选器
定义要筛选的项目。 有关详细信息,请参阅 定义项目。
在发布数据库中的发布服务器上,执行 sp_articlefilter (Transact-SQL)。 为 @article指定项目的名称,为 @publication指定发布的名称,为 @filter_name指定筛选器的名称,并为 @filter_clause 指定筛选子句(不包括
WHERE
)。如果还必须定义列筛选器,请参阅 定义和修改列筛选器。 否则,执行 sp_articleview (Transact-SQL)。 为 @publication指定发布名称、为 @article指定筛选项目的名称,并为 @filter_clause指定在步骤 2 中指定的筛选子句。 这将为筛选的项目创建同步对象。
为快照发布或事务发布修改静态行筛选器
在发布数据库中的发布服务器上,执行 sp_articlefilter (Transact-SQL)。 为 @article指定项目的名称,为 @publication指定发布的名称,为 @filter_name指定新筛选器的名称,并为 @filter_clause 指定新筛选子句(不包括
WHERE
)。 由于此更改将使现有订阅中的数据失效,因此请将 @force_reinit_subscription 的值指定为 1。在发布数据库中的发布服务器上,执行 sp_articleview (Transact-SQL)。 为 @publication指定发布名称,为 @article指定筛选项目的名称,为 @filter_clause指定步骤 1 中指定的筛选子句。 这将重新创建定义筛选项目的视图。
对发布重新运行快照代理作业以生成更新的快照。 有关详细信息,请参阅 创建并应用初始快照。
重新初始化订阅。 有关详细信息,请参阅 重新初始化订阅。
为快照发布或事务发布删除静态行筛选器
在发布数据库中的发布服务器上,执行 sp_articlefilter (Transact-SQL)。 为 @article指定项目的名称,为 @publication指定发布的名称,将 @filter_name的值指定为 NULL,并将 @filter_clause的值指定为 NULL。 由于此更改将使现有订阅中的数据失效,因此请将 @force_reinit_subscription 的值指定为 1。
对发布重新运行快照代理作业以生成更新的快照。 有关详细信息,请参阅 创建并应用初始快照。
重新初始化订阅。 有关详细信息,请参阅 重新初始化订阅。
为合并发布定义静态行筛选器
在发布数据库中的发布服务器上,执行 sp_addmergearticle (Transact-SQL)。 为 @subset_filterclause 指定筛选子句(不包括
WHERE
)。 有关详细信息,请参阅 定义项目。如果还必须定义列筛选器,请参阅 定义和修改列筛选器。
为合并发布修改静态行筛选器
在发布数据库中的发布服务器上,执行 sp_changemergearticle (Transact-SQL)。 为 @publication指定发布名称,为 @article指定筛选项目的名称,为 @property 指定 subset_filterclause值,并为 @value 指定新筛选子句(不包括
WHERE
)。 由于此更改将使现有订阅中的数据失效,因此请将 @force_reinit_subscription的值指定为 1。对发布重新运行快照代理作业以生成更新的快照。 有关详细信息,请参阅 创建并应用初始快照。
重新初始化订阅。 有关详细信息,请参阅 重新初始化订阅。
示例 (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
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈