發行項
09/24/2010

如何：定義發行項 (複寫 Transact-SQL 程式設計)

在建立發行集之後，可以使用複寫預存程序來以程式設計的方式建立發行項。要使用哪些預存程序來建立發行項，將取決於定義此發行項的發行集類型而定。如需詳細資訊，請參閱＜如何：建立發行集 (複寫 Transact-SQL 程式設計)＞。

[!附註]

發行項名稱不能包含下列任何字元： % , * , [ , ] , | , : , " , ? , ' , \ , / , < , >. 如果資料庫中的物件包含這些字元的任何一個，而且您要複寫它們，則必須指定一個不同於物件名稱的發行項名稱。

為快照式或交易式發行集定義發行項

在發行集資料庫的發行者上，執行 sp_addarticle。為 @publication 指定發行項所屬的發行集名稱、為 @article 指定發行項名稱、為 @source_object 指定發行的資料庫物件，以及指定其他任何選擇性參數。使用 @source_owner 來指定此物件的結構描述擁有權 (如果不是 dbo)。如果此發行項不是記錄式資料表發行項，請為 @type 指定發行項類型。如需詳細資訊，請參閱＜如何：指定發行項類型 (複寫 Transact-SQL 程式設計)＞。
若要以水平方式篩選資料表中的資料列或是檢視發行項，請使用 sp_articlefilter 來定義篩選子句。如需詳細資訊，請參閱＜如何：定義及修改靜態資料列篩選 (複寫 Transact-SQL 程式設計)＞。
若要以垂直方式篩選資料表中的資料行或是檢視發行項，請使用 sp_articlecolumn。如需詳細資訊，請參閱＜如何：定義及修改資料行篩選 (複寫 Transact-SQL 程式設計)＞。
如果發行項已經過篩選，請執行 sp_articleview。
如果發行集有現有的訂閱，而且 sp_helppublication 在 immediate_sync 資料行中傳回 0 的值，您就必須呼叫 sp_addsubscription，將此發行項加入到每一個現有的訂閱中。
如果發行集有現有的提取訂閱，請在發行者上執行 sp_refreshsubscriptions，針對只包含新發行項的現有提取訂閱建立新的快照集。

[!附註]

如果是未使用快照集初始化的訂閱，您就不需要執行 sp_refreshsubscriptions，因為這個程序是由 sp_addarticle 所執行。

為合併式發行集定義發行項

在發行集資料庫的發行者上，執行 sp_addmergearticle。為 @publication 指定發行集的名稱、為 @article 指定發行項的名稱，以及為 @source_object 指定發行的物件。若要以水平方式篩選資料表資料列，請指定 @subset_filterclause 的值。如需詳細資訊，請參閱＜如何：定義和修改合併發行項的參數化資料列篩選器 (複寫 Transact-SQL 程式設計)＞和＜如何：定義及修改靜態資料列篩選 (複寫 Transact-SQL 程式設計)＞。如果此發行項不是資料表發行項，請為 @type 指定發行項類型。如需詳細資訊，請參閱＜如何：指定發行項類型 (複寫 Transact-SQL 程式設計)＞。
(選擇性) 在發行集資料庫的發行者上，執行 sp_addmergefilter，以定義兩個發行項之間的聯結篩選。如需詳細資訊，請參閱＜如何：定義和修改合併發行項之間的聯結篩選 (複寫 Transact-SQL 程式設計)＞。
(選擇性) 在發行集資料庫的發行者上，執行 sp_mergearticlecolumn，以篩選資料表資料行。如需詳細資訊，請參閱＜如何：定義及修改資料行篩選 (複寫 Transact-SQL 程式設計)＞。

範例

此範例是根據交易式發行集的 Product 資料表來定義發行項，其中會以水平和垂直方式篩選發行項。

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

此範例會定義合併式發行集的發行項，其中的 SalesOrderHeader 發行項是根據 SalesPersonID 進行靜態篩選，而 SalesOrderDetail 發行項則是根據 SalesOrderHeader 進行聯結篩選。

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