sp_droppullsubscription (Transact-SQL)
適用対象: 
SQL Server Azure SQL Managed Instance
サブスクライバーの現在のデータベースにあるサブスクリプションを削除します。 このストアド プロシージャは、サブスクライバー側でプル サブスクリプション データベースについて実行されます。
構文
sp_droppullsubscription
[ @publisher = ] N'publisher'
[ , [ @publisher_db = ] N'publisher_db' ]
, [ @publication = ] N'publication'
[ , [ @reserved = ] reserved ]
[ , [ @from_backup = ] from_backup ]
[ ; ]
引数
[ @publisher = ] N'publisher'
リモート サーバー名。 @publisher は sysname で、既定値はありません。 all場合、サブスクリプションはすべてのパブリッシャーで削除されます。
[ @publisher_db = ] N'publisher_db'
パブリッシャー データベースの名前。 @publisher_db は sysname で、既定値は NULL です。 all は、すべてのパブリッシャー データベースを意味します。
[ @publication = ] N'publication'
パブリケーション名です。 @publication は sysname で、既定値はありません。 all場合、サブスクリプションはすべてのパブリケーションに削除されます。
[ @reserved = ] 予約済み
単に情報を示すためだけに特定されます。 サポートされていません。 将来の互換性は保証されません。
[ @from_backup = ] from_backup
単に情報を示すためだけに特定されます。 サポートされていません。 将来の互換性は保証されません。
リターン コードの値
0 (成功) または 1 (失敗)。
解説
sp_droppullsubscription は、スナップショット レプリケーションとトランザクション レプリケーションで使用されます。
sp_droppullsubscription は、 MSreplication_subscriptions テーブル内の対応する行とサブスクライバーの対応するディストリビューター エージェントを削除します。 MSreplication_subscriptionsに行が残っていない場合は、テーブルが削除されます。
例
-- 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'AdventureWorks2022';
USE [AdventureWorks2022Replica]
EXEC sp_droppullsubscription
@publisher = @publisher,
@publisher_db = @publicationDB,
@publication = @publication;
GO
アクセス許可
sysadmin固定サーバー ロールのメンバー、またはプル サブスクリプションを作成したユーザーのみがsp_droppullsubscriptionを実行できます。 固定データベース ロール db_owner は、プル サブスクリプションを作成したユーザーがこのロールに属している場合にのみ、 sp_droppullsubscription を実行できます。