針對合併發行項定義及修改參數化資料列篩選
適用於：
SQL Server
本主題說明如何使用 SQL Server Management Studio 或 Transact-SQL 在 SQL Server 中定義和修改參數化資料列篩選器。
在建立資料表發行項時，您可以使用參數化資料列篩選器。 這些篩選器會使用 WHERE 子句來選取要發行的適當資料。 您可以指定下列系統函數的其中一或兩個，而非在子句中指定常值 (如同對靜態資料列篩選的處理)：SUSER_SNAME 和 HOST_NAME。 如需詳細資訊，請參閱＜ 參數化資料列篩選器＞。
本主題內容
開始之前：
若要定義及修改參數化資料列篩選，請使用：
開始之前
限制事項
- 如果您在初始化發行集的訂閱後，新增、修改或刪除參數化資料列篩選，則必須在進行變更後產生新的快照集並重新初始化所有訂閱。 如需屬性變更需求的詳細資訊，請參閱變更發行集與發行項屬性。
建議
- 基於效能的考量，我們建議您不要在參數化資料列篩選器子句中，將函數套用至資料行名稱上，如
LEFT([MyColumn]) = SUSER_SNAME()。 如果在篩選子句中使用 HOST_NAME，並且覆寫 HOST_NAME 值，則可能需要使用 CONVERT 來轉換資料類型。 如需有關此案例之最佳做法的詳細資訊，請參閱主題＜ Parameterized Row Filters＞中的「覆寫 HOST_NAME() 值」一節。
使用 SQL Server Management Studio
您可以在 [新增發行集精靈] 的 [篩選資料表的資料列] 頁面上，或是在 [發行集屬性 - <發行集>] 對話方塊的 [篩選資料列] 頁面上，定義、修改及刪除參數化資料列篩選器。 如需使用精靈及存取對話方塊的詳細資訊，請參閱建立發行集和檢視及修改發行集屬性。
若要定義參數化資料列篩選器
在 [新增發行集精靈] 的 [篩選資料表的資料列] 頁面上，或是在 [發行集屬性 - <發行集>] 的 [篩選資料列] 頁面上，按一下 [加入]，然後按一下 [加入篩選]。
在 [加入篩選] 對話方塊中，從下拉式清單方塊中選取要篩選的資料表。
在 [篩選陳述式] 文字方塊中建立篩選陳述式。 您可直接在文字區域輸入，也可以從 [資料行] 清單方塊中拖曳資料行。
[篩選陳述式] 文字區域包括預設文字，其格式為：
SELECT <published_columns> FROM [tableowner].[tablename] WHERE預設的文字無法變更；使用標準 SQL 語法，在 WHERE 關鍵字後面輸入篩選子句。 參數化篩選包括對系統函數 HOST_NAME() 與/或 SUSER_SNAME() 的呼叫，或參考上述一或兩個函數的使用者定義函數。 下列為參數化資料列篩選器的完整篩選子句範例：
SELECT <published_columns> FROM [HumanResources].[Employee] WHERE LoginID = SUSER_SNAME()WHERE 子句應使用兩部份命名；不支援三部份及四部份命名。
選取符合資料在訂閱者之間共用資料方式的選項：
這個資料表中的一個資料列會提供給多個訂閱
這個資料表中的一個資料列只會提供給一個訂閱
若您選取 [這個資料表中的一個資料列只會提供給一個訂閱] ，合併式複寫可藉由儲存和處理較少中繼資料來將效能最佳化。 不過您必須確定資料分割方式不會將資料列複寫至多個訂閱者。 如需進一步資訊，請參閱主題＜ 參數化資料列篩選器＞中的「設定資料分割選項」。
選取 [確定]。
如果您在 [發行集屬性 - <發行集>] 對話方塊中，請按一下 [確定] 以儲存並關閉對話方塊。
若要修改參數化資料列篩選器
在 [新增發行集精靈] 的 [篩選資料表的資料列] 頁面上，或是在 [發行集屬性 - <發行集>] 的 [篩選資料列] 頁面上，從 [已篩選的資料表] 窗格中選取一個篩選，然後按一下 [編輯]。
在 [編輯篩選] 對話方塊中，修改篩選。
選取 [確定]。
若要刪除參數化資料列篩選器
- 在 [新增發行集精靈] 的 [篩選資料表的資料列] 頁面上，或是在 [發行集屬性 - <發行集>] 的 [篩選資料列] 頁面上，從 [已篩選的資料表] 窗格中選取一個篩選，然後按一下 [刪除]。
使用 TRANSACT-SQL
您可以使用複寫預存程序來以程式設計的方式建立及修改參數化資料列篩選器。
針對合併式發行集中的發行項定義參數化資料列篩選器
在發行集資料庫的發行者端，執行 sp_addmergearticle (Transact-SQL)。 指定 @publication、針對 @article指定發行項的名稱、針對 @source_object指定發行的資料表、針對 @subset_filterclause (不包括
WHERE) 指定定義參數化篩選器的 WHERE 子句，以及針對 @partition_options(用來描述從參數化資料列篩選器產生的資料分割類型) 指定下列其中一個值：0 - 發行項的篩選是靜態的，或是不產生每個資料分割的唯一資料子集 (也就是「重疊」的資料分割)。
1 - 產生的資料分割是重疊的，而且在訂閱者上進行的更新並不會變更資料列所屬的資料分割。
2 - 發行項的篩選會產生非重疊的資料分割，但多個訂閱者可以接收相同的資料分割。
3 - 發行項的篩選會產生對每項訂閱而言都是唯一的非重疊資料分割。
針對合併式發行集中的發行項變更參數化資料列篩選器
在發行集資料庫的發行者上，執行 sp_changemergearticle。 指定 @publication、指定 @article、為 @property 指定 subset_filterclause 值、為 @value (不包括
WHERE) 指定定義參數化篩選器的運算式，並為 @force_invalidate_snapshot 和 @force_reinit_subscription 指定 1 值。如果此變更會產生不同的資料分割行為，則再次執行 sp_changemergearticle 。 指定 @publication、指定 @article、針對 @property 指定 partition_options的值，以及針對 @value指定最適當的資料分割選項，可以是下列其中一項：
0 - 發行項的篩選是靜態的，或是不產生每個資料分割的唯一資料子集 (也就是「重疊」的資料分割)。
1 - 產生的資料分割是重疊的，而且在訂閱者上進行的更新並不會變更資料列所屬的資料分割。
2 - 發行項的篩選會產生非重疊的資料分割，但多個訂閱者可以接收相同的資料分割。
3 - 發行項的篩選會產生對每項訂閱而言都是唯一的非重疊資料分割。
範例 (Transact-SQL)
此範例會在合併式發行集中定義一組發行項，其中的發行項會使用一系列的聯結篩選來針對 Employee 資料表進行篩選 (此資料表本身是使用 LoginID 資料行上的參數化資料列篩選來進行篩選)。 在同步處理期間，會覆寫 HOST_NAME 函數傳回的值。 如需詳細資訊，請參閱＜ Parameterized Row Filters＞主題中的「覆寫 HOST_NAME() 值」。
-- To avoid storing the login and password in the script file, the value
-- is passed into SQLCMD as a scripting variable. For information about
-- how to use scripting variables on the command line and in SQL Server
-- Management Studio, see the "Executing Replication Scripts" section in
-- the topic "Programming Replication Using System Stored Procedures".
--Add a new merge publication.
DECLARE @publicationdb AS sysname;
DECLARE @publication AS sysname;
DECLARE @table1 AS sysname;
DECLARE @table2 AS sysname;
DECLARE @filter AS sysname;
DECLARE @schema_hr AS sysname;
DECLARE @schema_sales AS sysname;
SET @publicationdb = N'AdventureWorks2022';
SET @publication = N'AdvWorksSalesPersonMerge';
SET @table1 = N'Employee';
SET @table2 = N'SalesPerson';
SET @filter = N'SalesPerson_Employee';
SET @schema_hr = N'HumanResources';
SET @schema_sales = N'Sales';
USE [AdventureWorks2022];
-- Enable AdventureWorks2022 for merge replication.
EXEC sp_replicationdboption
@dbname = @publicationdb,
@optname = N'merge publish',
@value = N'true';
-- Create new merge publication with Subscriber requested snapshot
-- and using the default agent schedule.
EXEC sp_addmergepublication
@publication = @publication,
@description = N'Merge publication of AdventureWorks2022.',
@allow_subscriber_initiated_snapshot = N'true',
@publication_compatibility_level = N'90RTM';
-- Create a new snapshot job for the publication, using the default schedule.
-- Pass credentials at runtime using sqlcmd scripting variables.
EXEC sp_addpublication_snapshot
@publication = @publication,
@job_login = $(login),
@job_password = $(password);
-- Add an article for the Employee table,
-- which is horizontally partitioned using
-- a parameterized row filter.
EXEC sp_addmergearticle
@publication = @publication,
@article = @table1,
@source_owner = @schema_hr,
@source_object = @table1,
@type = N'table',
@description = 'contains employee information',
@subset_filterclause = N'[LoginID] = HOST_NAME()';
-- Add an article for the SalesPerson table,
-- which is partitioned based on a join filter.
EXEC sp_addmergearticle
@publication = @publication,
@article = @table2,
@source_owner = @schema_sales,
@source_object = @table2,
@type = N'table',
@description = 'contains salesperson information';
-- Add a join filter between the two articles.
EXEC sp_addmergefilter
@publication = @publication,
@article = @table1,
@filtername = @filter,
@join_articlename = @table2,
@join_filterclause = N'[Employee].[BusinessEntityID] = [SalesPerson].[SalesPersonID]',
@join_unique_key = 1,
@filter_type = 1;
GO
-- Start the agent job to generate the full snapshot for the publication.
-- The filtered data snapshot is generated automatically the first time
-- the subscription is synchronized.
DECLARE @publication AS sysname;
SET @publication = N'AdvWorksSalesPersonMerge';
EXEC sp_startpublication_snapshot
@publication = @publication;
GO
另請參閱
意見反應
即將登場：在 2024 年，我們將逐步淘汰 GitHub 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應