Compartilhar via


sp_dropmergearticle (Transact-SQL)

Remove um artigo de uma publicação de mesclagem. 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_dropmergearticle [ @publication= ] 'publication'
        , [ @article= ] 'article' 
    [ , [ @ignore_distributor= ] ignore_distributor 
    [ , [ @reserved= ] reserved 
    [ , [ @force_invalidate_snapshot= ] force_invalidate_snapshot ]
    [ , [ @force_reinit_subscription = ] force_reinit_subscription ]
    [ , [ @ignore_merge_metadata = ] ignore_merge_metadata ]

Argumentos

  • [ @publication=] 'publication'
    É o nome da publicação na qual descartar um artigo. publication é sysname, sem padrão.

  • [ @article=] 'article'
    É o nome do artigo a ser descartado na publicação específica. article é sysname, sem padrão. Se for all, todos os artigos existentes na publicação de mesclagem especificada serão removidos. Mesmo se article for all, a publicação ainda deverá ser descartada separadamente do artigo.

  • [ @ ignore_distributor =] ignore_distributor
    Indica se esse procedimento armazenado será executado sem se conectar ao Distribuidor. ignore_distributor é bit, com um padrão 0.

  • [ @reserved=] reserved
    Reservado para uso futuro. reserved é nvarchar (20), com um padrão NULL.

  • [ @force_invalidate_snapshot=] force_invalidate_snapshot
    Habilita ou desabilita a capacidade de ter um instantâneo invalidado. force_invalidate_snapshot é um pouco, com um padrão 0.

    0 especifica que as alterações no artigo de mesclagem não invalidam o instantâneo.

    1 significa que as alterações no artigo de mesclagem podem invalidar o instantâneo, e se esse for o caso, um valor 1 dá permissão para a ocorrência do novo instantâneo.

  • [ @force_reinit_subscription = ] force_reinit_subscription
    Reconhece que o descarte do artigo requer que as assinaturas existentes sejam reiniciadas. force_reinit_subscription é um bit, com um padrão 0.

    0 especifica que o descarte do artigo não causa a reinicialização da assinatura.

    1 especifica que o descarte do artigo causa a reinicialização de assinaturas existentes e dá permissão para que ocorra a reinicialização da assinatura.

  • [ @ignore_merge_metadata= ] ignore_merge_metadata
    Somente para uso interno.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Comentários

sp_dropmergearticle é usado em replicação de mesclagem. Para obter mais informações sobre descarte de artigos, consulte Adicionando artigos e descartando artigos de publicações existentes.

A execução de sp_dropmergearticle para descartar um artigo de uma publicação não remove 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 @table1 AS sysname;
DECLARE @table2 AS sysname;
DECLARE @table3 AS sysname;
DECLARE @salesschema AS sysname;
DECLARE @hrschema AS sysname;
DECLARE @filterclause AS nvarchar(1000);
SET @publication = N'AdvWorksSalesOrdersMerge'; 
SET @table1 = N'Employee'; 
SET @table2 = N'SalesOrderHeader'; 
SET @table3 = N'SalesOrderDetail'; 
SET @salesschema = N'Sales';
SET @hrschema = N'HumanResources';
SET @filterclause = N'Employee.LoginID = HOST_NAME()';

-- Drop the merge join filter between SalesOrderHeader and SalesOrderDetail.
EXEC sp_dropmergefilter 
  @publication = @publication, 
  @article = @table3, 
  @filtername = N'SalesOrderDetail_SalesOrderHeader', 
  @force_invalidate_snapshot = 1, 
  @force_reinit_subscription = 1;

-- Drops the merge join filter between Employee and SalesOrderHeader.
EXEC sp_dropmergefilter 
  @publication = @publication, 
  @article = @table2, 
  @filtername = N'SalesOrderHeader_Employee', 
  @force_invalidate_snapshot = 1, 
  @force_reinit_subscription = 1;

-- Drops the article for the SalesOrderDetail table.
EXEC sp_dropmergearticle 
  @publication = @publication, 
  @article = @table3,
  @force_invalidate_snapshot = 1, 
  @force_reinit_subscription = 1;

-- Drops the article for the SalesOrderHeader table.
EXEC sp_dropmergearticle 
  @publication = @publication, 
  @article = @table2, 
  @force_invalidate_snapshot = 1, 
  @force_reinit_subscription = 1;

-- Drops the article for the Employee table.
EXEC sp_dropmergearticle 
  @publication = @publication, 
  @article = @table1,
  @force_invalidate_snapshot = 1, 
  @force_reinit_subscription = 1;
GO

DECLARE @publication AS sysname;
DECLARE @article1 AS sysname;
DECLARE @article2 AS sysname;
SET @publication = N'AdvWorksSalesOrdersMerge';
SET @article1 = N'SalesOrderDetail'; 
SET @article2 = N'SalesOrderHeader'; 

-- Remove articles from a merge publication.
USE [AdventureWorks]
EXEC sp_dropmergearticle 
  @publication = @publication, 
  @article = @article1,
  @force_invalidate_snapshot = 1;
EXEC sp_dropmergearticle 
  @publication = @publication, 
  @article = @article2,
  @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_dropmergearticle.