Delete an Article (Удаление статьи)

Область применения: SQL Server Управляемый экземпляр SQL Azure

В этом разделе описывается удаление статьи в SQL Server с помощью объектов Transact-SQL или объектов управления репликацией (RMO). Сведения об условиях, при которых статьи можно удалить, и о том, требуется ли при удалении статьи создавать новый моментальный снимок или повторно инициализировать подписки, см. в разделе Добавление статей в существующие публикации и удаление статей из них.

Использование Transact-SQL

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

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

  1. Выполните sp_droparticle (Transact-SQL), чтобы удалить статью, указанную @article, из публикации, указанной @publication. Укажите значение 1 в параметре @force_invalidate_snapshot.

  2. (Необязательно) Чтобы полностью удалить опубликованный объект из базы данных, выполните команду DROP <objectname> на издателе для базы данных публикации.

Удалить статью из публикации слияния

  1. Выполните sp_dropmergearticle (Transact-SQL), чтобы удалить статью, указанную @article, из публикации, указанной @publication. При необходимости укажите значение 1 в параметре @force_invalidate_snapshot и значение 1 в параметре @force_reinit_subscription.

  2. (Необязательно) Чтобы полностью удалить опубликованный объект из базы данных, выполните команду DROP <objectname> на издателе для базы данных публикации.

Примеры (Transact-SQL)

В следующем примере удаляется статья из транзакционной публикации. Поскольку это изменение делает существующий снимок недействительным, для параметра @force_invalidate_snapshot указывается значение 1.

DECLARE @publication AS sysname;  
DECLARE @article AS sysname;  
SET @publication = N'AdvWorksProductTran';   
SET @article = N'Product';   
  
-- Drop the transactional article.  
USE [AdventureWorks]  
EXEC sp_droparticle   
  @publication = @publication,   
  @article = @article,  
  @force_invalidate_snapshot = 1;  
GO  

В следующем примере две статьи удаляются из публикации слиянием. Поскольку эти изменения делают существующий моментальный снимок недействительным, для параметра @force_invalidate_snapshot указывается значение 1.

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  

Использование объектов управления репликацией (RMO)

Вы можете удалять статьи программно с помощью объектов управления репликацией (RMO). Классы RMO, используемые для удаления статьи, зависят от типа публикации, к которой принадлежит эта статья.

Удалить статью, принадлежащую публикации моментальных снимков или транзакционной публикации

  1. Создайте соединение с издателем с помощью класса ServerConnection .

  2. Создайте экземпляр класса TransArticle.

  3. Установите свойства Name, PublicationNameи DatabaseName .

  4. Установите соединение, заданное на шаге 1, для свойства ConnectionContext.

  5. Проверьте свойство IsExistingObject , чтобы убедиться, что статья существует. Если это свойство имеет значение false, значит, на шаге 3 были неправильно заданы свойства статьи либо статья не существует.

  6. Вызовите метод Remove .

  7. Закройте все соединения.

Удалить статью, относящуюся к публикации слиянием

  1. Создайте соединение с издателем с помощью класса ServerConnection .

  2. Создайте экземпляр класса MergeArticle.

  3. Установите свойства Name, PublicationNameи DatabaseName .

  4. Установите соединение, заданное на шаге 1, для свойства ConnectionContext.

  5. Проверьте свойство IsExistingObject , чтобы убедиться, что статья существует. Если это свойство имеет значение false, значит, на шаге 3 были неправильно заданы свойства статьи либо статья не существует.

  6. Вызовите метод Remove .

  7. Закройте все соединения.