sp_dropmergepublication (Transact-SQL)

Artigo
03/07/2014

Descarta uma publicação de mesclagem e seu Agente de Instantâneo 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ópico Convenções da 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 removida. publication é sysname, sem padrão. Se for all, todas as publicações de mesclagem existentes serão removidas, bem como o Agente de Instantâneo associado a elas. Se você especificar um valor determinado para publication, somente aquela publicação e seu Agente de Instantâneo associado serão descartados.
[ @ignore_distributor =] ignore_distributor
Usado para remover uma publicação sem tarefas de limpeza no Distribuidor. ignore_distributor é bit, com um padrão de 0. Esse parâmetro também é usado ao reinstalar o Distribuidor.
[ @reserved=] reserved
É reservado para uso futuro. reserved é bit, com um padrão de 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 Excluir uma assinatura push e Excluir uma assinatura pull.

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'AdventureWorks'

-- Remove the merge publication.
USE [AdventureWorks]
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