sp_droppullsubscription (Transact-SQL)

Aplica-se a: SQL Server Instância Gerenciada de SQL do Azure

Descarta uma assinatura no banco de dados atual do Assinante. Esse procedimento armazenado é executado no Assinante, no banco de dados de assinatura pull.

Convenções de sintaxe de Transact-SQL

Sintaxe

sp_droppullsubscription
    [ @publisher = ] N'publisher'
    [ , [ @publisher_db = ] N'publisher_db' ]
    , [ @publication = ] N'publication'
    [ , [ @reserved = ] reserved ]
    [ , [ @from_backup = ] from_backup ]
[ ; ]

Argumentos

@publisher [ = ] N'editor'

O nome do servidor remoto. @publisher é sysname, sem padrão. Se all, a assinatura é descartada em todos os Editores.

@publisher_db [ = ] N'publisher_db'

O nome do banco de dados Publicador. @publisher_db é sysname, com um padrão de NULL. all significa todos os bancos de dados do Editor.

@publication [ = ] N'publicação'

O nome da publicação. @publication é sysname, sem padrão. Se all, a assinatura será descartada para todas as publicações.

@reserved [ = ] reservado

Identificado apenas para fins informativos. Não há suporte. A compatibilidade futura não está garantida.

@from_backup [ = ] from_backup

Identificado apenas para fins informativos. Não há suporte. A compatibilidade futura não está garantida.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Comentários

sp_droppullsubscription é usado na replicação de instantâneo e na replicação transacional.

sp_droppullsubscription exclui a linha correspondente na tabela MSreplication_subscriptions e o Agente Distribuidor correspondente no Assinante. Se nenhuma linha for deixada em MSreplication_subscriptions, ele descartará a tabela.

Exemplos

-- This script uses sqlcmd scripting variables. They are in the form
-- $(MyVariable). For information about how to use scripting variables  
-- on the command line and in SQL Server Management Studio, see the 
-- "Executing Replication Scripts" section in the topic
-- "Programming Replication Using System Stored Procedures".

-- This is the batch executed at the Subscriber to drop 
-- a pull subscription to a transactional publication.
DECLARE @publication AS sysname;
DECLARE @publisher AS sysname;
DECLARE @publicationDB     AS sysname;
SET @publication = N'AdvWorksProductTran';
SET @publisher = $(PubServer);
SET @publicationDB = N'AdventureWorks2022';

USE [AdventureWorks2022Replica]
EXEC sp_droppullsubscription 
  @publisher = @publisher, 
  @publisher_db = @publicationDB, 
  @publication = @publication;
GO

Permissões

Somente membros da função de servidor fixa sysadmin ou o usuário que criou a assinatura pull podem executar sp_droppullsubscription. A db_owner função de banco de dados fixa só poderá ser executada sp_droppullsubscription se o usuário que criou a assinatura pull pertencer a essa função.