sys.sp_droparticle (Transact-SQL)

Aplica-se a: SQL ServerAzure SQL Managed Instance

Elimina um artigo de uma publicação instantânea ou transacional. Um artigo não pode ser removido se existirem uma ou mais subscrições. Este procedimento armazenado é executado no Publisher no banco de dados de publicação.

Transact-SQL convenções de sintaxe

Syntax

sys.sp_droparticle
    [ @publication = ] N'publication'
    , [ @article = ] N'article'
    [ , [ @ignore_distributor = ] ignore_distributor ]
    [ , [ @force_invalidate_snapshot = ] force_invalidate_snapshot ]
    [ , [ @publisher = ] N'publisher' ]
    [ , [ @from_drop_publication = ] from_drop_publication ]
[ ; ]

Arguments

[ @publication = ] N'publicação'

O nome da publicação que contém o artigo será retirado. @publication é sysname, sem padrão.

[ @article = ] N'artigo'

O nome do artigo a ser retirado. @article é sysname, sem padrão.

[ @ignore_distributor = ] ignore_distributor

Identificado apenas para fins informativos. Não suportado. A compatibilidade futura não é garantida.

@force_invalidate_snapshot [ = ] force_invalidate_snapshot

Reconhece que a ação tomada por este procedimento armazenado pode invalidar um snapshot existente. @force_invalidate_snapshot é bit, com um padrão de 0.

  • 0 Especifica que as alterações no artigo não fazem com que o instantâneo seja inválido. Se o procedimento armazenado detetar que a alteração requer um novo snapshot, ocorre um erro e não são feitas alterações.

  • 1 especifica que alterações ao artigo podem tornar o snapshot inválido e, se existirem subscrições existentes que exijam um novo snapshot, dá permissão para que o snapshot existente seja marcado como obsoleto e gerado um novo snapshot.

@publisher [ = ] N'editor'

Especifica um Editor de Server que não seja SQL. @publisher é sysname, com um padrão de NULL.

Este parâmetro não deve ser usado ao alterar propriedades de artigos numa SQL Server Publisher.

[ @from_drop_publication = ] from_drop_publication

Identificado apenas para fins informativos. Não suportado. A compatibilidade futura não é garantida.

Valores de código de retorno

0 (sucesso) ou 1 (fracasso).

Remarks

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

Para artigos com filtro horizontal, sp_droparticle verifica a type coluna do artigo na tabela sysarticles para determinar se uma vista ou filtro também deve ser eliminado. Se uma visualização ou filtro foi gerado automaticamente, é eliminado juntamente com o artigo. Se foi criado manualmente, não é eliminado.

Executar sp_droparticle a eliminação de um artigo de uma publicação não remove o objeto da base de dados da publicação nem o objeto correspondente da base de dados por subscrição. Use DROP <object> para remover manualmente estes objetos, se necessário.

Examples

DECLARE @publication AS sysname;
DECLARE @article AS sysname;
SET @publication = N'AdvWorksProductTran'; 
SET @article = N'Product'; 

-- Drop the transactional article.
USE [AdventureWorks2022]
EXEC sp_droparticle 
  @publication = @publication, 
  @article = @article,
  @force_invalidate_snapshot = 1;
GO

Permissions

Apenas os membros do papel fixo de servidor administrador do sistema ou db_owner papel fixo de base de dados podem executar sp_droparticle.

Conteúdo relacionado

  • Last updated on