sp_dropmergepublication (Transact-SQL)

Aplica-se a: SQL Server (todas as versões com suporte)

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 publicador.

Topic link iconConvenções de sintaxe do 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 suspensa. publicação é sysname, sem padrão. Se for tudo, todas as publicações de mesclagem existentes serão removidas, bem como o trabalho Agente de Instantâneo associado a elas. Se você especificar um valor específico para publicação, somente essa publicação e seu trabalho de Agente de Instantâneo associado serão descartados.

[ @ignore_distributor = ] ignore_distributor Usado para descartar uma publicação sem realizar 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. reservado é bit, com um padrão de 0.

[ @ignore_merge_metadata = ] ignore_merge_metadata Somente uso interno.

Valores do código de retorno

0 (êxito) ou 1 (falha)

Comentários

sp_dropmergepublication é usado na replicação de mesclagem.

sp_dropmergepublication descarta recursivamente todos os artigos associados a uma publicação e, em seguida, descarta a própria publicação. Uma publicação não poderá ser removida se tiver uma ou mais assinaturas associadas. Para obter informações sobre como remover assinaturas, consulte Excluir uma assinatura por push e excluir uma assinatura pull.

Executar sp_dropmergepublication para remover uma publicação não remove objetos publicados do banco de dados de publicação ou dos objetos correspondentes do banco de dados de assinatura. Use o objeto> DROP <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

Permissões

Somente membros da função de servidor fixa sysadmin ou da db_owner função de banco de dados fixa podem executar sp_dropmergepublication.

Consulte Também

Excluir uma publicação
sp_addmergepublication (Transact-SQL)
sp_changemergepublication (Transact-SQL)
sp_helpmergepublication (Transact-SQL)
Procedimentos armazenados de replicação (Transact-SQL)