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.