sp_dropmergesubscription (Transact-SQL)
适用范围:SQL Server
删除对合并发布的订阅及其关联的合并代理。 此存储过程在发布服务器上对发布数据库执行。
语法
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_type 为 nvarchar(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
。