sp_droparticle (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 descartado. publication é sysname, sem padrão.

• [ @article=] 'article'
  É o nome do artigo a ser descartado. 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
  Reconhece que a ação tomada por esse procedimento armazenado pode invalidar um instantâneo existente. force_invalidate_snapshot é um bit, com um padrão 0.

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

  1 especifica que as alterações no artigo 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 não-Microsoft SQL Server. publisher é sysname, com um padrão NULL.

  Observação
  O publicador 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 [AdventureWorks2008R2]
EXEC sp_droparticle 
  @publication = @publication, 
  @article = @article,
  @force_invalidate_snapshot = 1;
GO

Permissões

Somente membros da função de servidor fixa sysadmin ou da função de banco de dados fixa db_owner podem executar sp_droparticle.

Consulte também

Tarefas

Referência

Conceitos