sp_droparticle (Transact-SQL)sp_droparticle (Transact-SQL)

APLICA-SE A: simSQL Server simBanco de Dados SQL do Azure (somente a Instância Gerenciada) nãoAzure Synapse Analytics (SQL DW) nãoParallel Data Warehouse APPLIES TO: yesSQL Server yesAzure SQL Database (Managed Instance only) noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse

Descarta um artigo de uma publicação de instantâneo ou transacional.Drops an article from a snapshot or transactional publication. Um artigo não poderá ser removido se tiver uma ou mais assinaturas associadas.An article cannot be removed if one or more subscriptions to it exist. Esse procedimento armazenado é executado no Publicador, no banco de dados publicador.This stored procedure is executed at the Publisher on the publication database.

Ícone de link do tópico Convenções de sintaxe de Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SintaxeSyntax

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

ArgumentosArguments

[ @publication = ] 'publication'É o nome da publicação que contém o artigo a ser Descartado.[ @publication = ] 'publication' Is the name of the publication that contains the article to be dropped. a publicação é sysname, sem padrão.publication is sysname, with no default.

[ @article = ] 'article'É o nome do artigo a ser removido.[ @article = ] 'article' Is the name of the article to be dropped. o artigo é sysname, sem padrão.article is sysname, with no default.

[ @ignore_distributor = ] ignore_distributor Identificado apenas para fins informativos.Identified for informational purposes only. Sem suporte.Not supported. A compatibilidade futura não está garantida.Future compatibility is not guaranteed.[ @ignore_distributor = ] ignore_distributor Identificado apenas para fins informativos.Identified for informational purposes only. Sem suporte.Not supported. A compatibilidade futura não está garantida.Future compatibility is not guaranteed.

[ @force_invalidate_snapshot = ] force_invalidate_snapshotO reconhece que a ação executada por esse procedimento armazenado pode invalidar um instantâneo existente.[ @force_invalidate_snapshot = ] force_invalidate_snapshot Acknowledges that the action taken by this stored procedure may invalidate an existing snapshot. force_invalidate_snapshot é um bit, com um padrão de 0.force_invalidate_snapshot is a bit, with a default of 0.

0 especifica que as alterações no artigo não fazem com que o instantâneo seja inválido.0 specifies that changes to the article do not cause the snapshot to be invalid. Se o procedimento armazenado detectar que a alteração requer um novo instantâneo, ocorrerá um erro e nenhuma alteração será feita.If the stored procedure detects that the change does require a new snapshot, an error occurs and no changes are made.

1 especifica que as alterações no artigo podem fazer com que o instantâneo seja inválido e, se houver assinaturas existentes que exijam um novo instantâneo, concederá permissão para o instantâneo existente ser marcado como obsoleto e um novo instantâneo gerado.1 specifies that changes to the article may cause the snapshot to be invalid, and if there are existing subscriptions that would require a new snapshot, gives permission for the existing snapshot to be marked as obsolete and a new snapshot generated.

[ @publisher = ] 'publisher'Especifica um não MicrosoftMicrosoft SQL ServerSQL Server Publicador.[ @publisher = ] 'publisher' Specifies a non- MicrosoftMicrosoft SQL ServerSQL Server Publisher. o Publicador é sysname, com um padrão de NULL.publisher is sysname, with a default of NULL.

Observação

o Publicador não deve ser usado ao alterar as propriedades SQL ServerSQL Server do artigo em um Publicador.publisher should not be used when changing article properties on a SQL ServerSQL Server Publisher.

[ @from_drop_publication = ] from_drop_publication Identificado apenas para fins informativos.Identified for informational purposes only. Sem suporte.Not supported. A compatibilidade futura não está garantida.Future compatibility is not guaranteed.[ @from_drop_publication = ] from_drop_publication Identificado apenas para fins informativos.Identified for informational purposes only. Sem suporte.Not supported. A compatibilidade futura não está garantida.Future compatibility is not guaranteed.

Valores do código de retornoReturn Code Values

0 (êxito) ou 1 (falha)0 (success) or 1 (failure)

ComentáriosRemarks

sp_droparticle é usado em instantâneo e replicação transacional.sp_droparticle is used in snapshot and transactional replication.

Para artigos filtrados horizontalmente, sp_droparticle verifica a coluna tipo do artigo na tabela Transact () -SQL sysarticles para determinar se um modo de exibição ou filtro também deve ser Descartado.For horizontally filtered articles, sp_droparticle checks the type column of the article in the sysarticles (Transact-SQL) table to determine whether a view or filter should also be dropped. Se uma exibição ou filtro foram gerados automaticamente, serão descartados com o artigo.If a view or filter was autogenerated, it is dropped with the article. Se foram criados manualmente, não serão descartados.If it was manually created, it is not dropped.

A execução de sp_droparticle para descartar 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.Executing sp_droparticle to drop an article from a publication does not remove the object from the publication database or the corresponding object from the subscription database. Use DROP <object> para remover esses objetos manualmente, se necessário.Use DROP <object> to manually remove these objects if necessary.

ExemploExample

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

PermissõesPermissions

Somente os membros da função de servidor fixa sysadmin ou da função de banco de dados fixa db_owner podem executar sp_droparticle.Only members of the sysadmin fixed server role or db_owner fixed database role can execute sp_droparticle.

Consulte tambémSee Also

Excluir um artigo Delete an Article
Adicionar e remover artigos de publicações existentes Add Articles to and Drop Articles from Existing Publications
sp_addarticle (Transact-SQL) sp_addarticle (Transact-SQL)
sp_changearticle (Transact-SQL) sp_changearticle (Transact-SQL)
sp_helparticle (Transact-SQL) sp_helparticle (Transact-SQL)
sp_helparticlecolumns (Transact-SQL) sp_helparticlecolumns (Transact-SQL)
Procedimentos armazenados de replicação (Transact-SQL)Replication Stored Procedures (Transact-SQL)