sp_dropmergearticle (Transact-SQL)

Статья
05/08/2013

Удаляет статью из публикации слиянием. Эта хранимая процедура выполняется на издателе в базе данных публикации.

Значок ссылки на раздел Синтаксические обозначения в Transact-SQL

Синтаксис

sp_dropmergearticle [ @publication= ] 'publication' 
        , [ @article= ] 'article' 
    [ , [ @ignore_distributor= ] ignore_distributor 
    [ , [ @reserved= ] reserved 
    [ , [ @force_invalidate_snapshot= ] force_invalidate_snapshot ]
    [ , [ @force_reinit_subscription = ] force_reinit_subscription ]
    [ , [ @ignore_merge_metadata = ] ignore_merge_metadata ]

Аргументы

[ @publication=] 'publication'
Имя публикации, из которой следует удалить статью. Аргумент publicationимеет тип sysname и не имеет значения по умолчанию.
[ @article=] 'article'
Имя статьи, которую следует удалить из данной публикации. Аргумент articleимеет тип sysname и не имеет значения по умолчанию. Если указано значение all, то будут удалены все статьи в указанной публикации слиянием. Даже если параметр article имеет значение all, публикацию нужно будет удалить отдельным вызовом.
[ @ignore_distributor=] ignore_distributor
Указывает, исполняется ли данная хранимая процедура без подключения к распространителю. Аргумент ignore_distributor имеет тип bit и значение по умолчанию 0.
[ @reserved=] reserved
Зарезервировано для использования в будущем. Аргумент reserved имеет тип nvarchar(20) и значение по умолчанию NULL.
[ @force_invalidate_snapshot=] force_invalidate_snapshot
Включает или отключает возможность наличия недействительных моментальных снимков. Аргумент force_invalidate_snapshot имеет тип bit и значение по умолчанию 0.

Значение 0 определяет, что изменения в статье слияния не приводит к недействительности моментального снимка.

1 означает, что изменения в статье слияния могут сделать моментальный снимок недействительным, и в этом случае значение 1 дает разрешение создать новый моментальный снимок.
[ @force_reinit_subscription = ] force_reinit_subscription
Подтверждает, что удаление статьи требует повторной инициализации существующих подписок. Аргумент force_reinit_subscription имеет тип bit и значение по умолчанию 0.

0 указывает на то, что удаление статьи не вызывает повторной инициализации подписки.

1 означает, что удаление статьи вызывает повторную инициализацию подписок, и дает разрешение произвести повторную инициализацию.
[ @ignore_merge_metadata= ] ignore_merge_metadata
Только для внутреннего использования.

Значения кодов возврата

0 (успешное завершение) или 1 (неуспешное завершение)

Замечания

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

Удаление статьи из публикации с помощью процедуры sp_dropmergearticle не удаляет ни объект из базы данных публикации, ни соответствующий объект из базы данных подписки. При необходимости эти объекты могут быть удалены вручную при помощи инструкции DROP <object>.

Пример

DECLARE @publication AS sysname;
DECLARE @article1 AS sysname;
DECLARE @article2 AS sysname;
SET @publication = N'AdvWorksSalesOrdersMerge';
SET @article1 = N'SalesOrderDetail'; 
SET @article2 = N'SalesOrderHeader'; 

-- Remove articles from a merge publication.
USE [AdventureWorks]
EXEC sp_dropmergearticle 
  @publication = @publication, 
  @article = @article1,
  @force_invalidate_snapshot = 1;
EXEC sp_dropmergearticle 
  @publication = @publication, 
  @article = @article2,
  @force_invalidate_snapshot = 1;
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()';

-- Drop the merge join filter between SalesOrderHeader and SalesOrderDetail.
EXEC sp_dropmergefilter 
  @publication = @publication, 
  @article = @table3, 
  @filtername = N'SalesOrderDetail_SalesOrderHeader', 
  @force_invalidate_snapshot = 1, 
  @force_reinit_subscription = 1;

-- Drops the merge join filter between Employee and SalesOrderHeader.
EXEC sp_dropmergefilter 
  @publication = @publication, 
  @article = @table2, 
  @filtername = N'SalesOrderHeader_Employee', 
  @force_invalidate_snapshot = 1, 
  @force_reinit_subscription = 1;

-- Drops the article for the SalesOrderDetail table.
EXEC sp_dropmergearticle 
  @publication = @publication, 
  @article = @table3,
  @force_invalidate_snapshot = 1, 
  @force_reinit_subscription = 1;

-- Drops the article for the SalesOrderHeader table.
EXEC sp_dropmergearticle 
  @publication = @publication, 
  @article = @table2, 
  @force_invalidate_snapshot = 1, 
  @force_reinit_subscription = 1;

-- Drops the article for the Employee table.
EXEC sp_dropmergearticle 
  @publication = @publication, 
  @article = @table1,
  @force_invalidate_snapshot = 1, 
  @force_reinit_subscription = 1;
GO

Разрешения

Только члены предопределенной роли сервера sysadmin или предопределенной роли базы данных db_owner могут выполнять хранимую процедуру sp_dropmergearticle.