Excluir um artigo

Aplica-se a: simSQL Server (todas as versões compatíveis) SimInstância Gerenciada do Azure SQL

Este tópico descreve como excluir um artigo no SQL Server usando o Transact-SQL ou RMO (Replication Management Objects). Para obter informações sobre as condições nas quais os artigos podem ser removidos e se a remoção de um artigo requer um novo instantâneo ou a reinicialização de assinaturas, consulte Adicionar e remover artigos de publicações existentes.

Neste tópico

Usando o Transact-SQL

Os artigos podem ser excluídos de forma programática usando procedimentos armazenados de replicação. Os procedimentos armazenados usados dependem do tipo de publicação ao qual o artigo pertence.

Para excluir um artigo de um instantâneo ou publicação transacional

  1. Execute sp_droparticle (Transact-SQL) para excluir um artigo, especificado por @article, de uma publicação, especificado por @publication. Especifique um valor igual a 1 em @force_invalidate_snapshot.

  2. (Opcional) Para remover inteiramente o objeto publicado de um banco de dados, execute o comando DROP <objectname> no Publicador do banco de dados de publicação.

Para excluir um artigo de uma publicação de mesclagem

  1. Execute sp_dropmergearticle (Transact-SQL) para excluir um artigo, especificado por @article, de uma publicação, especificado por @publication. Se necessário, especifique um valor igual a 1 em @force_invalidate_snapshot e um valor igual a 1 em @force_reinit_subscription.

  2. (Opcional) Para remover inteiramente o objeto publicado de um banco de dados, execute o comando DROP <objectname> no Publicador do banco de dados de publicação.

Exemplos (Transact-SQL)

O exemplo a seguir exclui um artigo da publicação transacional. Como essa alteração invalida o instantâneo existente, um valor igual a 1 é especificado no parâmetro @force_invalidate_snapshot.

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  

O exemplo a seguir exclui dois artigos de uma publicação de mesclagem. Como essas alterações invalidam o instantâneo existente, um valor igual a 1 é especificado no parâmetro @force_invalidate_snapshot.

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  

Usando o RMO (Replication Management Objects)

Você pode excluir artigos programaticamente usando o RMO (Replication Management Objects). As classes RMO que você usa para excluir um artigo dependem do tipo de publicação a que o artigo pertence.

Para excluir um artigo que pertence a uma publicação de instantâneo ou transacional

  1. Crie uma conexão com o Publicador usando a classe ServerConnection .

  2. Criar uma instância da classe TransArticle.

  3. Defina as propriedades Name, PublicationNamee DatabaseName .

  4. Defina a conexão da etapa 1 para a propriedade ConnectionContext .

  5. Verifique a propriedade IsExistingObject para se certificar de que o artigo existe. Se o valor desta propriedade for false, as propriedades do artigo na etapa 3 foram definidas incorretamente ou o artigo não existe.

  6. Chame o método Remove .

  7. Feche todas as conexões.

Para excluir um artigo que pertence a uma publicação de mesclagem

  1. Crie uma conexão com o Publicador usando a classe ServerConnection .

  2. Criar uma instância da classe MergeArticle.

  3. Defina as propriedades Name, PublicationNamee DatabaseName .

  4. Defina a conexão da etapa 1 para a propriedade ConnectionContext .

  5. Verifique a propriedade IsExistingObject para se certificar de que o artigo existe. Se o valor desta propriedade for false, as propriedades do artigo na etapa 3 foram definidas incorretamente ou o artigo não existe.

  6. Chame o método Remove .

  7. Feche todas as conexões.

Consulte Também

Adicionar e remover artigos de publicações existentes
Replication System Stored Procedures Concepts