sp_dropdistributiondb (Transact-SQL)
ディストリビューション データベースを削除します。データベースが使用している物理ファイルを、別のデータベースが使用していない場合に削除します。このストアド プロシージャは、任意のデータベース上のディストリビュータ側で実行されます。
.gif "トピック リンク アイコン")
構文
sp_dropdistributiondb [ @database= ] 'database'
引数
- [ @database=] 'database'
削除するデータベースを指定します。database のデータ型は sysname で、既定値はありません。
戻り値
0 (成功) または 1 (失敗)
説明
sp_dropdistributiondb は、すべての種類のレプリケーションで使用できます。
sp_dropdistributor を実行してディストリビュータを削除する前に、このストアド プロシージャを実行する必要があります。
ディストリビューション データベースにキュー リーダー エージェント ジョブが存在する場合、sp_dropdistributiondb ではそのジョブも削除されます。
ディストリビューションを無効にするには、ディストリビューション データベースがオンラインであることが必要です。ディストリビューション データベースに対してデータベース スナップショットが存在する場合は、ディストリビューションを無効にする前に、このスナップショットを削除する必要があります。データベース スナップショットは、データベースの読み取り専用のオフライン コピーであり、レプリケーション スナップショットには関係していません。詳細については、「データベース スナップショット」を参照してください。
使用例
-- 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".
-- Disable publishing and distribution.
DECLARE @distributionDB AS sysname;
DECLARE @publisher AS sysname;
DECLARE @publicationDB as sysname;
SET @distributionDB = N'distribution';
SET @publisher = $(DistPubServer);
SET @publicationDB = N'AdventureWorks2008R2';
-- Disable the publication database.
USE [AdventureWorks2008R2]
EXEC sp_removedbreplication @publicationDB;
-- Remove the registration of the local Publisher at the Distributor.
USE master
EXEC sp_dropdistpublisher @publisher;
-- Delete the distribution database.
EXEC sp_dropdistributiondb @distributionDB;
-- Remove the local server as a Distributor.
EXEC sp_dropdistributor;
GO
権限
sp_dropdistributiondb を実行できるのは、sysadmin 固定サーバー ロールのメンバだけです。