定義及修改靜態資料列篩選

發行項
08/21/2023

適用於：SQL Server Azure SQL 受控執行個體

本主題說明如何使用 SQL Server Management Studio 或 Transact-SQL 在 SQL Server 中定義和修改靜態資料列篩選。

本主題內容

開始之前：

限制事項

建議
若要定義及修改靜態資料列篩選，請使用：

SQL Server Management Studio

Transact-SQL

開始之前

限制事項

如果您在初始化發行集的訂閱後，新增、修改或刪除靜態資料列篩選，則必須在進行變更後產生新的快照集並重新初始化所有訂閱。如需屬性變更需求的詳細資訊，請參閱變更發行集與發行項屬性。
如果為點對點異動複寫啟用發行集，則無法篩選資料表。

建議

由於這些篩選都是靜態的，所以所有訂閱者都將收到相同子集的資料。如果您需要動態篩選屬於合併式發行集之資料表發行項內的資料，好讓每一個訂閱者都會收到不同的資料分割，請參閱＜針對合併發行項定義及修改參數化資料列篩選＞。合併式複寫也可讓您根據現有的資料列篩選來篩選相關的資料列。如需詳細資訊，請參閱定義和修改合併發行項之間的聯結篩選。

使用 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

另請參閱

針對合併發行項定義及修改參數化資料列篩選
 變更發行集與發行項屬性
 篩選發行的資料
 合併式複寫之篩選發行資料