Excluir um artigo

Artigo
04/26/2023

Aplica-se a: SQL Server Instância Gerenciada de SQL do Azure

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

Para excluir um artigo, usando:

Transact-SQL

RMO (Replication Management Objects)

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

Execute sp_droparticle (Transact-SQL) para excluir um artigo, especificado por @article, de uma publicação, especificado por @publication. Especifique um valor de 1 para @force_invalidate_snapshot.
(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

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 de 1 para @force_invalidate_snapshot e um valor de 1 para @force_reinit_subscription.
(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 de 1 é especificado para o 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 de 1 é especificado para o 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

Crie uma conexão com o Publicador usando a classe ServerConnection .
Criar uma instância da classe TransArticle.
Defina as propriedades Name, PublicationNamee DatabaseName .
Defina a conexão da etapa 1 para a propriedade ConnectionContext .
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.
Chame o método Remove .
Feche todas as conexões.

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

Crie uma conexão com o Publicador usando a classe ServerConnection .
Criar uma instância da classe MergeArticle.
Defina as propriedades Name, PublicationNamee DatabaseName .
Defina a conexão da etapa 1 para a propriedade ConnectionContext .
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.
Chame o método Remove .
Feche todas as conexões.

Confira também

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

Compartilhar via