Excluir um artigo
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:
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.