sp_droppullsubscription (Transact-SQL)

Удаляет подписку в текущей базе данных подписчика. Эта хранимая процедура выполняется на подписчике в базе данных подписки по запросу.

Значок ссылки на разделСинтаксические обозначения в Transact-SQL

Синтаксис

sp_droppullsubscription [ @publisher= ] 'publisher'
        , [ @publisher_db= ] 'publisher_db'
        , [ @publication= ] 'publication'
    [ , [ @reserved= ] reserved ]

Аргументы

  • [ @publisher= ] 'publisher'
    Имя удаленного сервера. Аргумент publisher имеет тип sysname и не имеет значения по умолчанию. Если значение равно all, удаляется подписка на всех серверах издателя.

  • [ @publisher_db= ] 'publisher_db'
    Имя базы данных издателя. Аргумент publisher_db имеет тип sysname и не имеет значения по умолчанию. Значение all означает все базы данных издателя.

  • [ @publication= ] 'publication'
    Имя публикации. Аргумент publication имеет тип sysname и не имеет значения по умолчанию. Если значение равно all, удаляется подписка на все публикации.

  • [ @reserved= ] reserved
    Указано только в ознакомительных целях. Не поддерживается. Совместимость с будущими версиями не гарантируется.

Значения кодов возврата

0 (успешное завершение) или 1 (неуспешное завершение)

Замечания

Хранимая процедура sp_droppullsubscription используется в репликации моментальных снимков и репликации транзакций.

Процедура sp_droppullsubscription удаляет соответствующую строку в таблице MSreplication_subscriptions (Transact-SQL) и соответствующего агента распространителя на сервере подписчика. Если в таблице MSreplication_subscriptions (Transact-SQL) строк не осталось, она удаляется.

Пример

-- 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'AdventureWorks2008R2';

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

Разрешения

Хранимую процедуру sp_droppullsubscription могут выполнять только члены предопределенной роли сервера sysadmin или пользователь, создавший подписку по запросу. Члены предопределенной роли базы данных db_owner могут выполнять хранимую процедуру sp_droppullsubscription, если пользователь, создавший подписку по запросу, принадлежит к этой роли.