• Artigo

sp_dropmergepublication (Transact-SQL)

Descarta uma publicação de mesclagem e seu Snapshot Agent associado. Todas as assinaturas devem ser descartadas antes de descartar uma publicação de mesclagem. Os artigos na publicação são descartados automaticamente. 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_dropmergepublication [ @publication= ] 'publication' 
    [ , [ @ignore_distributor = ] ignore_distributor ] 
    [ , [ @reserved = ] reserved ]
    [ , [ @ignore_merge_metadata = ] ignore_merge_metadata ]

Argumentos

  • [ @publication=] 'publication'
    É o nome da publicação a ser descartada. publication é sysname, sem padrão. Se for all, todas as publicações de mesclagem existentes serão removidas, bem como o Snapshot Agent associado a elas. Se você especificar um valor determinado para publication, somente aquela publicação e seu Snapshot Agent associado serão descartados.

  • [ @ignore_distributor =] ignore_distributor
    Usado para descartar uma publicação sem tarefas de limpeza no Distribuidor. ignore_distributor é bit, com um padrão 0. Esse parâmetro também é usado ao reinstalar o Distribuidor.

  • [ @reserved=] reserved
    Reservado para uso posterior. reserved é bit, com um padrão 0.

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

Valores de código de retorno

0 (êxito) ou 1 (falha)

Comentários

sp_dropmergepublication é usado em replicação de mesclagem.

sp_dropmergepublication descarta recursivamente todos os artigos associados à publicação e, depois, descarta a própria publicação. Uma publicação não poderá ser removida se tiver uma ou mais assinaturas associadas. Para obter mais informações sobre como remover assinaturas, consulte Como excluir uma assinatura push (Programação Transact-SQL de replicação) e Como excluir uma assinatura pull (Programação Transact-SQL de replicação).

A execução de sp_dropmergepublication para descartar uma publicação não remove objetos publicados do banco de dados de publicação ou objetos correspondente do banco de dados de assinatura. Use DROP <objeto> para remover esses objetos manualmente, se necessário.

Exemplo

DECLARE @publication AS sysname
DECLARE @publicationDB    AS sysname
SET @publication = N'AdvWorksSalesOrdersMerge' 
SET @publicationDB = N'AdventureWorks2008R2'

-- Remove the merge publication.
USE [AdventureWorks2008R2]
EXEC sp_dropmergepublication @publication = @publication;

-- Remove replication objects from the database.
USE master
EXEC sp_replicationdboption 
  @dbname = @publicationDB, 
  @optname = N'merge publish', 
  @value = N'false'
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_dropmergepublication.