sp_dropmergesubscription (Transact-SQL)

适用范围:SQL Server

删除对合并发布的订阅及其关联的合并代理。 此存储过程在发布服务器上对发布数据库执行。

Transact-SQL 语法约定

语法

sp_dropmergesubscription
    [ [ @publication = ] N'publication' ]
    [ , [ @subscriber = ] N'subscriber' ]
    [ , [ @subscriber_db = ] N'subscriber_db' ]
    [ , [ @subscription_type = ] N'subscription_type' ]
    [ , [ @ignore_distributor = ] ignore_distributor ]
    [ , [ @reserved = ] reserved ]
[ ; ]

参数

[ @publication = ] N'publication'

发布名。 @publication为 sysname,默认值为 NULL. 发布必须已存在,并且必须符合标识符的规则

[ @subscriber = ] N'subscriber'

订阅服务器的名称。 @subscriber为 sysname,默认值为 NULL.

[ @subscriber_db = ] N'subscriber_db'

订阅数据库的名称。 @subscriber_db为 sysname,默认值为 NULL.

[ @subscription_type = ] N'subscription_type'

订阅的类型。 @subscription_typenvarchar(15),可以是其中一个值。

说明
all 推送订阅、请求订阅和匿名订阅
anonymous 匿名订阅。
push 推送订阅。
pull 请求订阅。
both(默认值) 推送订阅和请求订阅。

[ @ignore_distributor = ] ignore_distributor

指示是否在未连接到分发服务器的情况下执行此存储过程。 @ignore_distributor,默认值为 0. 该参数可用于删除订阅,但不清除分发服务器上的任务。 如果必须重新安装分发服务器,它也很有用。

[ @reserved = ] reserved

保留供将来使用。 @reserved,默认值为 0.

返回代码值

0(成功)或 1(失败)。

注解

sp_dropmergesubscription 用于合并复制。

示例

-- 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 batch is executed at the Publisher to remove 
-- a pull or push subscription to a merge publication.
DECLARE @publication AS sysname;
DECLARE @subscriber AS sysname;
DECLARE @subscriptionDB AS sysname;
SET @publication = N'AdvWorksSalesOrdersMerge';
SET @subscriber = $(SubServer);
SET @subscriptionDB = N'AdventureWorks2022Replica';

USE [AdventureWorks2022]
EXEC sp_dropmergesubscription 
  @publication = @publication, 
  @subscriber = @subscriber, 
  @subscriber_db = @subscriptionDB;
GO

权限

只有 sysadmin 固定服务器角色的成员db_owner固定数据库角色的成员才能执行sp_dropmergesubscription