共用方式為

針對合併發行項定義及修改參數化資料列篩選

  • 發行項

本主題描述如何使用 SQL Server Management Studio 或 Transact-SQL 在 SQL Server 2012 中定義及修改參數化資料列篩選。

在建立資料表發行項時，您可以使用參數化資料列篩選器。 這些篩選器會使用 WHERE 子句來選取要發行的適當資料。 您可以指定下列系統函數的其中之一或兩者，而不要在子句中指定常值 (如同處理靜態資料列篩選)：SUSER_SNAME 和 HOST_NAME。 如需詳細資訊，請參閱＜參數化資料列篩選器＞。

本主題內容

  • 開始之前：

    限制事項

    安全性

  • 若要定義及修改參數化資料列篩選，請使用：

    SQL Server Management Studio

    Transact-SQL

開始之前

限制事項

  • 如果您在初始化發行集的訂閱後，新增、修改或刪除參數化資料列篩選，則必須在進行變更後產生新的快照集並重新初始化所有訂閱。 如需屬性變更需求的資訊，請參閱＜變更發行集與發行項屬性＞。

建議

  • 基於效能的考量，我們建議您不要在參數化資料列篩選器子句中，將函數套用至資料行名稱上，如 LEFT([MyColumn]) = SUSER_SNAME()。 如果在篩選子句中使用 HOST_NAME，並且覆寫 HOST_NAME 值，則可能需要使用 CONVERT 來轉換資料類型。 如需有關這個情況最佳作法的詳細資訊，請參閱＜參數化資料列篩選器＞主題中的＜覆寫 HOST_NAME() 值＞一節。

搭配回到頁首連結使用的箭頭圖示[Top]

使用 SQL Server Management Studio

在「新增發行集精靈」的 [篩選資料表資料列] 頁面，或在 [發行集屬性 - <Publication>] 對話方塊的 [篩選資料列] 頁面中，定義、修改和刪除參數化資料列篩選器。 如需有關使用此精靈及存取此對話方塊的詳細資訊，請參閱＜建立發行集＞和＜檢視及修改發行集屬性＞。

若要定義參數化資料列篩選器

  1. 在「新增發行集精靈」的 [篩選資料表的資料列] 頁面，或在 [發行集屬性 - <Publication>] 的 [篩選資料列] 頁面中，按一下 [加入]，然後按一下 [加入篩選]。

  2. 在 [加入篩選] 對話方塊中，從下拉式清單方塊中選取要篩選的資料表。

  3. 在 [篩選陳述式] 文字方塊中建立篩選陳述式。 您可直接在文字區域輸入，也可以從 [資料行] 清單方塊中拖曳資料行。

    • [篩選陳述式] 文字區域包括預設文字，其格式為：

      SELECT <published_columns> FROM [tableowner].[tablename] WHERE

    • 預設的文字無法變更；使用標準 SQL 語法，在 WHERE 關鍵字後面輸入篩選子句。 參數化篩選包括對系統函數 HOST_NAME() 與/或 SUSER_SNAME() 的呼叫，或參考上述一或兩個函數的使用者定義函數。 下列為參數化資料列篩選器的完整篩選子句範例：

      SELECT <published_columns> FROM [HumanResources].[Employee] WHERE LoginID = SUSER_SNAME()

      WHERE 子句應使用兩部份命名；不支援三部份及四部份命名。

  4. 選取符合資料在訂閱者之間共用資料方式的選項：

    • 這個資料表中的一個資料列會提供給多個訂閱

    • 這個資料表中的一個資料列只會提供給一個訂閱

    若您選取 [這個資料表中的一個資料列只會提供給一個訂閱]，合併式複寫可藉由儲存和處理較少中繼資料來將效能最佳化。 不過您必須確定資料分割方式不會將資料列複寫至多個訂閱者。 如需進一步資訊，請參閱主題＜參數化資料列篩選器＞中的「設定資料分割選項」。

  5. 按一下 [確定]。  

  6. 如果您是在 [發行集屬性 - <Publication>] 對話方塊中，請按一下 [確定] 以儲存並關閉對話方塊。

若要修改參數化資料列篩選器

  1. 在新增發行集精靈的 [篩選資料表的資料列] 頁面，或者 [發行集屬性 - <Publication>] 的 [篩選資料列] 頁面上，選取 [已篩選的資料表] 窗格中的篩選，然後按一下 [編輯]。

  2. 在 [編輯篩選] 對話方塊中，修改篩選。

  3. 按一下 [確定]。  

若要刪除參數化資料列篩選器

  • 在新增發行集精靈的 [篩選資料表的資料列] 頁面，或者 [發行集屬性 - <Publication>] 的 [篩選資料列] 頁面上，選取 [已篩選的資料表] 窗格中的篩選，然後按一下 [刪除]。

搭配回到頁首連結使用的箭頭圖示[Top]

使用 Transact-SQL

您可以使用複寫預存程序來以程式設計的方式建立及修改參數化資料列篩選器。

針對合併式發行集中的發行項定義參數化資料列篩選器

  • 在發行集資料庫的發行者上，執行 sp_addmergearticle (Transact-SQL)。 指定 @publication、針對 @article 指定發行項的名稱、針對 @source_object 指定發行的資料表、針對 @subset_filterclause (不包括 WHERE) 指定定義參數化篩選器的 WHERE 子句，以及針對 @partition_options (用來描述從參數化資料列篩選器產生的資料分割類型) 指定下列其中一個值：

    • 0 - 發行項的篩選是靜態的，或是不產生每個資料分割的唯一資料子集 (也就是「重疊」的資料分割)。

    • 1 - 產生的資料分割是重疊的，而且在訂閱者上進行的更新並不會變更資料列所屬的資料分割。

    • 2 - 發行項的篩選會產生非重疊的資料分割，但多個訂閱者可以接收相同的資料分割。

    • 3 - 發行項的篩選會產生對每項訂閱而言都是唯一的非重疊資料分割。

針對合併式發行集中的發行項變更參數化資料列篩選器

  1. 在發行集資料庫的發行者上，執行 sp_changemergearticle。 指定 @publication、指定 @article、針對 @property 指定 subset_filterclause 值、針對 @value (不包括 WHERE) 指定定義參數化篩選器的運算式、針對 @force_invalidate_snapshot 和 @force_reinit_subscription 指定 1 的值。

  2. 如果此變更會產生不同的資料分割行為，則再次執行 sp_changemergearticle。 指定 @publication、指定 @article、針對 @property 指定 partition_options 的值，以及針對 @value 指定最適當的資料分割選項，可以是下列其中一項：

    • 0 - 發行項的篩選是靜態的，或是不產生每個資料分割的唯一資料子集 (也就是「重疊」的資料分割)。

    • 1 - 產生的資料分割是重疊的，而且在訂閱者上進行的更新並不會變更資料列所屬的資料分割。

    • 2 - 發行項的篩選會產生非重疊的資料分割，但多個訂閱者可以接收相同的資料分割。

    • 3 - 發行項的篩選會產生對每項訂閱而言都是唯一的非重疊資料分割。

範例 (Transact-SQL)

此範例會在合併式發行集中定義一組發行項，其中的發行項會使用一系列的聯結篩選來針對 Employee 資料表進行篩選 (此資料表本身是使用 LoginID 資料行上的參數化資料列篩選來進行篩選)。 在同步處理期間，會覆寫 HOST_NAME 函數傳回的值。 如需詳細資訊，請參閱＜參數化資料列篩選器＞主題中的「覆寫 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'AdventureWorks2012';
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 [AdventureWorks2012];

-- Enable AdventureWorks2012 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 AdventureWorks2012.', 
  @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

搭配回到頁首連結使用的箭頭圖示[Top]

請參閱

概念

定義和修改合併發行項之間的聯結篩選

變更發行集與發行項屬性

聯結篩選

參數化資料列篩選器