sp_droppublication (Transact-SQL)

適用対象: SQL Server Azure SQL Managed Instance

パブリケーションおよびこれと関連するスナップショット エージェントを削除します。 パブリケーションを削除する前に、すべてのサブスクリプションを削除する必要があります。 パブリケーション内のアーティクルは自動的に削除されます。 このストアド プロシージャは、パブリッシャー側のパブリケーション データベースで実行されます。

Transact-SQL 構文表記規則

構文

sp_droppublication
    [ @publication = ] N'publication'
    [ , [ @ignore_distributor = ] ignore_distributor ]
    [ , [ @publisher = ] N'publisher' ]
    [ , [ @from_backup = ] from_backup ]
[ ; ]

引数

[ @publication = ] N'publication'

削除するパブリケーションの名前。 @publicationsysname で、既定値はありません。 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