sp_dropmergesubscription (Transact-SQL)
適用対象: 
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 です。 パブリケーションは既に存在し、 identifiers の規則に準拠している必要があります。
[ @subscriber = ] N'subscriber'
サブスクライバーの名前。 @subscriber は sysname で、既定値は NULL です。
[ @subscriber_db = ] N'subscriber_db'
サブスクリプション データベースの名前。 @subscriber_db は sysname で、既定値は NULL です。
[ @subscription_type = ] N'subscription_type'
サブスクリプションの種類。 @subscription_type は nvarchar(15)であり、これらの値のいずれかを指定できます。
| Value | 説明 |
|---|---|
all |
プッシュ、プル、匿名のサブスクリプション |
anonymous |
匿名サブスクリプションです。 |
push |
プッシュ サブスクリプション。 |
pull |
プル サブスクリプションです。 |
both (既定) |
プッシュ サブスクリプションおよびプル サブスクリプションです。 |
[ @ignore_distributor = ] ignore_distributor
ディストリビューターに接続せずにこのストアド プロシージャを実行するかどうかを示します。 @ignore_distributor は bit で、既定値は 0 です。 このパラメーターを使用すると、ディストリビューターでクリーンアップ タスクを実行せずにサブスクリプションを削除できます。 ディストリビューターを再インストールする必要がある場合にも便利です。
[ @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を実行できます。