Partilhar via


sp_droparticle (Transact-SQL)

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ópicoConvenções de 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 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çãoObservaçã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.