sp_droparticle (Transact-SQL)

Artigo
03/07/2014

Descarta um artigo de uma publicação de instantâneo ou transacional. Um artigo não poderá ser removido se tiver uma ou mais assinaturas associadas. Esse procedimento armazenado é executado no Publicador, no banco de dados de publicação.

Ícone de vínculo de tópico Convenções da sintaxe Transact-SQL

Sintaxe

sp_droparticle [ @publication= ] 'publication' 
        , [ @article= ] 'article'
    [ , [ @ignore_distributor = ] ignore_distributor ]
    [ , [ @force_invalidate_snapshot= ] force_invalidate_snapshot ]
    [ , [ @publisher = ] 'publisher' ]
    [ , [ @from_drop_publication = ] from_drop_publication ]

Argumentos

[ @publication=] 'publication'
É o nome da publicação que contém o artigo a ser removido. publication é sysname, sem padrão.
[ @article=] 'article'
É o nome do artigo a ser removido. article é sysname, sem padrão.
[ @ignore_distributor =] ignore_distributor
Identificado apenas para fins informativos. Sem suporte. A compatibilidade futura não está garantida.
[ @force_invalidate_snapshot = ] force_invalidate_snapshot
Confirma que a ação tomada por esse procedimento armazenado pode invalidar um instantâneo existente. force_invalidate_snapshot é um bit, com um padrão de 0.

0 especifica que as alterações no artigo não invalidam o instantâneo. Se o procedimento armazenado detectar que a alteração requer um novo instantâneo, ocorrerá um erro e nenhuma alteração será feita.

1 especifica que as alterações no artigo de mesclagem podem invalidar o instantâneo e se houver assinaturas existentes que exigem um novo instantâneo, dará permissão para que o instantâneo existente seja marcado como obsoleto e um novo instantâneo seja gerado.
[ @publisher= ] 'publisher'
Especifica um Publicador que não é Microsoft SQL Server. publisher é sysname, com um padrão de NULL.

Dica

publisher não deve ser usado ao alterar propriedades de artigo em um Publicador SQL Server.
[ @from_drop_publication= ] from_drop_publication
Identificado apenas para fins informativos. Sem suporte. A compatibilidade futura não está garantida.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Comentários

sp_droparticle é usado em replicação de instantâneo e transacional.

Para artigos filtrados horizontalmente, sp_droparticle verifica a coluna type do artigo na tabela sysarticles (Transact-SQL) para determinar se uma exibição ou um filtro também devem ser descartados. Se uma exibição ou filtro foram gerados automaticamente, serão descartados com o artigo. Se foram criados manualmente, não serão descartados.

A execução de sp_droparticle para cancelar um artigo de uma publicação não remove o objeto do banco de dados de publicação ou o objeto correspondente do banco de dados de assinatura. Use DROP <object> para remover esses objetos manualmente, se necessário.

Exemplo

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