sp_addmergefilter (Transact-SQL)

项目
12/15/2008

添加新合并筛选以创建基于与另一个表的联接的分区。此存储过程在发布服务器的发布数据库中执行。

语法

sp_addmergefilter [ @publication = ] 'publication' 
        , [ @article = ] 'article' 
        , [ @filtername = ] 'filtername' 
        , [ @join_articlename = ] 'join_articlename' 
        , [ @join_filterclause = ] join_filterclause
    [ , [ @join_unique_key = ] join_unique_key ]
    [ , [ @force_invalidate_snapshot = ] force_invalidate_snapshot ]
    [ , [ @force_reinit_subscription = ] force_reinit_subscription ]
    [ , [ @filter_type = ] filter_type ]

参数

[ @publication= ] 'publication'
添加合并筛选的发布的名称。publication 的数据类型为 sysname，无默认值。

[ @article= ] 'article'
添加合并筛选的项目的名称。article 的数据类型为 sysname，无默认值。

[ @filtername= ] 'filtername'
筛选的名称。filtername 是必需的参数。filtername的数据类型为 sysname，无默认值。

[ @join_articlename= ] 'join_articlename'
子项目（由 article 指定）必须使用 join_filterclause 指定的联接子句进行联接，从而确定子项目中满足合并筛选条件的行的父项目。join_articlename 的数据类型为 sysname，无默认值。该项目必须位于 publication 给定的发布中。

[ @join_filterclause= ] join_filterclause
必须用于联接 article 指定的子项目和 join_article 指定的父项目，从而确定符合筛选条件的行的联接子句。join_filterclause 的数据类型为 nvarchar(1000)。

[ @join_unique_key= ] join_unique_key
指定子项目 article和父项目 join_article之间的联接是否为一对多、一对一、多对一或多对多的关系。join_unique_key 的数据类型为 int，默认值为 0。0 指示多对一或多对多联接。1 表示一对一或一对多联接。当联接的列形成 join_article 中的唯一键，或当 join_filterclause 位于 article 中的外键和 join_article 中的主键之间时，该值为 1。

注意：
仅当对保证唯一性的父项目的基础表中的联接列具有约束时，才将此参数设置为 1。如果错误地将 join_unique_key 设置为 1，则可能无法收敛数据。

[ @force_invalidate_snapshot= ] force_invalidate_snapshot
确认此存储过程所执行的操作是否会使现有快照失效。force_invalidate_snapshot 的数据类型为 bit，默认值为 0。

0 指定对合并项目所做的更改不会导致快照失效。如果该存储过程检测到更改确实需要新的快照，则会发生错误，并且不进行任何更改。

1 指定对合并项目所做的更改可能导致快照无效，如果现有订阅需要新快照，则向其授予将现有快照标记为过时并生成新快照的权限。

[ @force_reinit_subscription= ] force_reinit_subscription
确认此存储过程所执行的操作是否需要重新初始化现有订阅。force_reinit_subscription 的数据类型为 bit，默认值为 0。

0 指定对合并项目所做的更改不会导致重新初始化订阅。如果该存储过程检测到更改需要重新初始化订阅，则会发生错误，并且不进行任何更改。

1 指定对合并项目所做的更改可导致重新初始化现有的订阅，并且授予重新初始化订阅的权限。

[ @filter_type= ] filter_type
指定要添加的筛选类型。filter_type 的数据类型为 tinyint，可以是下列值之一：

值	说明
1	仅为联接筛选器。需要它来支持MicrosoftSQL Server 2005 Compact Edition订阅服务器。
2	仅为逻辑记录关系。
3	同时为联接筛选器和逻辑记录关系。

有关详细信息，请参阅通过逻辑记录对相关行的更改进行分组。

返回代码值

0（成功）或 1（失败）

备注

sp_addmergefilter 用于合并复制。

sp_addmergefilter 只能用于表项目。不支持视图项目和索引视图项目。

此过程也可用于在两个可能或不可能具有联接筛选器的项目之间添加逻辑关系。filter_type 用于指定所添加的合并筛选是否为联接筛选器、逻辑关系或同时为二者。

若要使用逻辑记录，发布和项目必须满足许多要求。有关详细信息，请参阅通过逻辑记录对相关行的更改进行分组。

通常，该选项用于具有对已发布的主键表的外键引用的项目，而且该主键表含有在其项目中定义的筛选。主键行的子集用于确定复制到订阅服务器的外键行。

当两个已发布项目的源表共享相同的表对象名称时，不能在这两个项目之间添加联接筛选器。在这种情况下，即使两个表属于不同的架构并具有唯一的项目名，也无法创建联接筛选器。

当在一个表项目上同时使用参数化行筛选器和联接筛选器时，复制会确定行是否属于某个订阅服务器的分区。执行上述操作的方法是：使用 OR 运算符计算筛选函数或联接筛选器，而不是使用 AND 运算符计算这两个条件的交集。

权限

只有 sysadmin 固定服务器角色成员或 db_owner 固定数据库角色成员才能执行 sp_addmergefilter。

示例

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.EmployeeID = 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

请参阅

sp_addmergefilter (Transact-SQL)

语法

参数

返回代码值

备注

权限

示例

请参阅

参考

其他资源

帮助和信息

其他资源