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

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

权限

只有 sysadmin 固定服务器角色成员或创建请求订阅的用户才能执行 sp_droppullsubscription。 如果创建该请求订阅的用户属于此角色,则 db_owner 固定数据库角色只能执行 sp_droppullsubscription