Excluir um artigo

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

Neste tópico

• Para excluir um artigo, usando:

  Transact-SQL

  RMO (Replication Management Objects)

Usando 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, especificada por @publication. Especifique um valor de 1 para @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, especificada por @publication. Se necessário, especifique um valor de 1 para @force_invalidate_snapshot e um valor de 1 para @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 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 [AdventureWorks2012]
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

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

[Top]

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. Crie uma instância da classe TransArticle.

3. Defina as propriedades Name, PublicationName e 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. Crie uma instância da classe MergeArticle.

3. Defina as propriedades Name, PublicationName e 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.

[Top]

Consulte também

Conceitos

Adicionar e remover artigos de publicações existentes

Conceitos dos procedimentos armazenados do sistema de replicação