Как определить статью (программирование репликации на языке Transact-SQL)

После создания публикации статьи можно создавать программно с помощью хранимых процедур репликации. Конкретные хранимые процедуры, применяемые для создания статей, будут зависеть от типа публикации, для которого определена статья. Дополнительные сведения см. в разделе Как создать публикацию (программирование репликации на языке Transact-SQL).

Примечание
Названия статей не могут содержать следующие символы: % , * , [ , ] , | , : , " , ? , ' , \ , / , < , >. Если объекты в базе данных, содержащие любые из этих символов, нужно реплицировать, необходимо задать для статьи имя, отличное от имени объекта.

Определение статьи для публикации транзакций или моментальных снимков

1. Выполните процедуру sp_addarticle на издателе в базе данных публикации. Укажите имя публикации, которой принадлежит статья, в качестве значения параметра @publication, имя статьи в качестве значения параметра @article, публикуемый объект базы данных в качестве значения параметра @source_object, а также, при необходимости, другие параметры. С помощью параметра @source_owner задайте принадлежность схемы объекта. Если она отсутствует, то dbo. Если статья не является статьей таблицы, основанной на журнале, укажите тип статьи в качестве значения параметра @type. Дополнительные сведения см. в разделе Как задать типы статей (программирование репликации на языке Transact-SQL).

2. Для горизонтальной фильтрации строк в таблице или для просмотра статьи используйте хранимую процедуру sp_articlefilter, определяющую предложение фильтра. Дополнительные сведения см. в разделе Как определить и изменить статический фильтр строк (программирование репликации на языке Transact-SQL).

3. Для вертикальной фильтрации столбцов в таблице или просмотра статьи используйте хранимую процедуру sp_articlecolumn. Дополнительные сведения см. в разделе Как определить и изменить фильтр столбцов (программирование репликации на языке Transact-SQL).

4. Если статья является фильтруемой, выполните хранимую процедуру sp_articleview.

5. Если публикация содержит существующие подписки и хранимая процедура sp_helppublication возвращает значение 0 в столбце immediate_sync, то необходимо с помощью хранимой процедуры sp_addsubscription добавить статью в каждую существующую подписку.

6. Если в публикации есть подписки по запросу, выполните хранимую процедуру sp_refreshsubscriptions на издателе для создания нового моментального снимка для существующих подписок по запросу, содержащего только новую статью.

   Примечание
   Для подписок, которые не были инициализированы с помощью моментального снимка, нет необходимости выполнять хранимую процедуру sp_refreshsubscriptions, поскольку она выполняется процедурой sp_addarticle.

Определение статьи для публикации слиянием

1. В базе данных публикации на издателе выполните процедуру sp_addmergearticle. Укажите имя публикации в качестве значения параметра @publication, имя статьи в качестве значения параметра @article, а также публикуемый объект в качестве значения параметра @source_object. Для горизонтальной фильтрации строк таблицы укажите значение параметра @subset_filterclause. Дополнительные сведения см. в образце кода Как определить и изменить параметризованный фильтр строк для статьи публикации слиянием (программирование репликации на языке Transact-SQL) и разделе Как определить и изменить статический фильтр строк (программирование репликации на языке Transact-SQL). Если статья не является статьей таблицы, укажите ее тип в качестве значения параметра @type. Дополнительные сведения см. в разделе Как задать типы статей (программирование репликации на языке Transact-SQL).

2. Выполните процедуру sp_addmergefilter на издателе в базе данных публикации, чтобы определить фильтр соединения между двумя статьями (необязательно). Дополнительные сведения см. в разделе Как определить и изменить фильтр соединения между статьями публикации слиянием (программирование репликации на языке Transact-SQL).

3. На издателе в базе данных публикации выполните хранимую процедуру 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.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

См. также

Задания

Как создать публикацию (программирование репликации на языке Transact-SQL)

Как определить статью (программирование объектов RMO)

Основные понятия

Добавление и удаление статей в существующих публикациях

Основные понятия о системных хранимых процедурах репликации

Публикация данных и объектов базы данных