Partilhar via


sp_droppublication (Transact-SQL)

Descarta uma publicação e seu Snapshot Agent associado. Todas as assinaturas devem ser descartadas antes de descartar uma publicação. 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_droppublication [ @publication= ] 'publication' 
    [ , [ @ignore_distributor = ] ignore_distributor ]

Argumentos

  • [ @publication= ] 'publication'
    É o nome da publicação a ser descartada. publication é sysname, sem padrão. Se all for especificado, todas as publicações serão descartadas do banco de dados de publicação, exceto aquelas com assinatura.

  • [ @ignore_distributor = ] ignore_distributor
    Identificado apenas para fins informativos. Sem suporte. A compatibilidade futura não está garantida.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Comentários

sp_droppublication é usado em replicação de instantâneo e replicação transacional.

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_droppublication 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 assinaturas. Use DROP <objeto> para remover esses objetos manualmente, se necessário.

Exemplos

DECLARE @publicationDB AS sysname;
DECLARE @publication AS sysname;
SET @publicationDB = N'AdventureWorks2008R2'; 
SET @publication = N'AdvWorksProductTran'; 

-- Remove a transactional publication.
USE [AdventureWorks2008R2]
EXEC sp_droppublication @publication = @publication;

-- Remove replication objects from the database.
USE [master]
EXEC sp_replicationdboption 
  @dbname = @publicationDB, 
  @optname = N'publish', 
  @value = N'false';
GO

Permissões

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