sp_droppublication (Transact-SQL)
適用対象: SQL ServerAzure SQL Managed Instance
パブリケーションおよびこれと関連するスナップショット エージェントを削除します。 パブリケーションを削除する前に、すべてのサブスクリプションを削除する必要があります。 パブリケーション内のアーティクルは自動的に削除されます。 このストアド プロシージャは、パブリッシャー側のパブリケーション データベースで実行されます。
構文
sp_droppublication
[ @publication = ] N'publication'
[ , [ @ignore_distributor = ] ignore_distributor ]
[ , [ @publisher = ] N'publisher' ]
[ , [ @from_backup = ] from_backup ]
[ ; ]
引数
[ @publication = ] N'publication'
削除するパブリケーションの名前。 @publicationは sysname で、既定値はありません。 指定した場合 all
、サブスクリプションを持つパブリケーションを除き、パブリケーション データベースからすべてのパブリケーションが削除されます。
[ @ignore_distributor = ] ignore_distributor
単に情報を示すためだけに特定されます。 サポートされていません。 将来の互換性は保証されません。
[ @publisher = ] N'publisher'
単に情報を示すためだけに特定されます。 サポートされていません。 将来の互換性は保証されません。
[ @from_backup = ] from_backup
単に情報を示すためだけに特定されます。 サポートされていません。 将来の互換性は保証されません。
リターン コードの値
0
(成功) または 1
(失敗)。
解説
sp_droppublication
は、スナップショット レプリケーションとトランザクション レプリケーションで使用されます。
sp_droppublication
パブリケーションに関連付けられているすべてのアーティクルを再帰的に削除してから、パブリケーション自体を削除します。 パブリケーションが 1 つ以上のサブスクリプションである場合、パブリケーションを削除することはできません。 サブスクリプションを削除する方法については、「プッシュ サブスクリプションの削除」および「プル サブスクリプションの削除」を参照してください。
パブリケーションを sp_droppublication
削除するために実行しても、パブリケーション データベースからパブリッシュされたオブジェクトや、対応するオブジェクトがサブスクリプション データベースから削除されることはありません。 必要であれば DROP <object>
を使用して、手動でこれらのオブジェクトを削除します。
アクセス許可
sysadmin 固定サーバー ロールのメンバーのみが実行sp_droppublication
できます。
例
DECLARE @publicationDB AS sysname;
DECLARE @publication AS sysname;
SET @publicationDB = N'AdventureWorks';
SET @publication = N'AdvWorksProductTran';
-- Remove a transactional publication.
USE [AdventureWorks2022]
EXEC sp_droppublication @publication = @publication;
-- Remove replication objects from the database.
USE [master]
EXEC sp_replicationdboption
@dbname = @publicationDB,
@optname = N'publish',
@value = N'false';
GO
関連するコンテンツ
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示