sp_dropmergepublication (Transact-SQL)

  • [アーティクル]

適用対象:SQL Server

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

Transact-SQL 構文表記規則

構文

sp_dropmergepublication
    [ @publication = ] N'publication'
    [ , [ @ignore_distributor = ] ignore_distributor ]
    [ , [ @reserved = ] reserved ]
    [ , [ @ignore_merge_metadata = ] ignore_merge_metadata ]
[ ; ]

引数

[ @publication = ] N'publication'

削除するパブリケーションの名前。 @publicationは sysname で、既定値はありません。 その場合all、既存のすべてのマージ パブリケーションと、それらに関連付けられているスナップショット エージェント ジョブが削除されます。 @publicationに特定の値を指定すると、そのパブリケーションとそれに関連付けられているスナップショット エージェント ジョブのみが削除されます。

[ @ignore_distributor = ] ignore_distributor

ディストリビューターでクリーンアップ タスクを実行せずにパブリケーションを削除するために使用されます。 @ignore_distributorはビットで、既定値は 0. このパラメーターは、ディストリビューターを再インストールするときにも使用されます。

[ @reserved = ] 予約済み

将来利用するために予約されています。 @reservedはビットで、既定値は 0.

[ @ignore_merge_metadata = ] ignore_merge_metadata

単に情報を示すためだけに特定されます。 サポートされていません。 将来の互換性は保証されません。

リターン コードの値

0 (成功) または 1 (失敗)。

解説

sp_dropmergepublication はマージ レプリケーションで使用されます。

sp_dropmergepublication は、パブリケーションに関連付けられているすべてのアーティクルを再帰的に削除してから、パブリケーション自体を削除します。 パブリケーションが 1 つ以上のサブスクリプションである場合、パブリケーションを削除することはできません。 サブスクリプションを削除する方法については、「プッシュ サブスクリプションの削除」および「プル サブスクリプションの削除」を参照してください。

パブリケーションを sp_dropmergepublication 削除するために実行しても、パブリケーション データベースからパブリッシュされたオブジェクトや、対応するオブジェクトがサブスクリプション データベースから削除されることはありません。 必要であれば DROP <object> を使用して、手動でこれらのオブジェクトを削除します。

例

DECLARE @publication AS sysname
DECLARE @publicationDB    AS sysname
SET @publication = N'AdvWorksSalesOrdersMerge' 
SET @publicationDB = N'AdventureWorks'

-- Remove the merge publication.
USE [AdventureWorks]
EXEC sp_dropmergepublication @publication = @publication;

-- Remove replication objects from the database.
USE master
EXEC sp_replicationdboption 
  @dbname = @publicationDB, 
  @optname = N'merge publish', 
  @value = N'false'
GO

アクセス許可

sysadmin 固定サーバー ロールまたは固定データベース ロールdb_ownerのメンバーのみが実行sp_dropmergepublicationできます。

関連するコンテンツ