sp_dropmergearticle (Transact-SQL)
Удаляет статью из публикации слиянием. Эта хранимая процедура выполняется на издателе в базе данных публикации.
.gif "Значок ссылки на раздел")
Синтаксические обозначения в 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>.
Разрешения
Только члены фиксированной серверной роли sysadmin или фиксированной роли базы данных db_owner могут выполнять хранимую процедуру sp_dropmergearticle.
Пример
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
См. также
Справочник
sp_addmergearticle (Transact-SQL)
sp_changemergearticle (Transact-SQL)
sp_helpmergearticle (Transact-SQL)
Хранимые процедуры репликации (Transact-SQL)
Другие ресурсы
How to: Delete an Article (Replication Transact-SQL Programming)
Добавление и удаление статей в существующих публикациях