sp_dropdistributiondb (Transact-SQL)

適用対象: SQL Server Azure SQL Managed Instance

ディストリビューション データベースを削除します。 別のデータベースで使用されていない場合は、データベースで使用されている物理ファイルを削除します。 このストアド プロシージャは、任意のデータベースのディストリビューターで実行されます。

Transact-SQL 構文表記規則

構文

sp_dropdistributiondb
    [ @database = ] N'database'
    [ , [ @former_ag_secondary = ] former_ag_secondary ]
[ ; ]

引数

[ @database = ] N'database'

削除するデータベース。 @databasesysname で、既定値はありません。

[ @former_ag_secondary = ] former_ag_secondary

このノードが以前にディストリビューション データベースの可用性グループの一部であったかどうかを指定します。 @former_ag_secondaryint で、既定値は 0 です。

リターン コードの値

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

解説

sp_dropdistributiondb は、すべての種類のレプリケーションで使用されます。

このストアド プロシージャは、 sp_dropdistributorを実行してディストリビューターを削除する前に実行する必要があります。

sp_dropdistributiondb また、ディストリビューション データベースのキュー リーダー エージェント ジョブ (存在する場合) も削除します。

ディストリビューションを無効にするには、ディストリビューション データベースがオンラインである必要があります。 ディストリビューション データベースのデータベース スナップショットが存在する場合は、ディストリビューションを無効にする前に削除する必要があります。 データベース スナップショットは、データベースの読み取り専用オフライン コピーであり、レプリケーション スナップショットとは関係ありません。 詳細については、「 Database スナップショット (SQL Server)」を参照してください。

-- 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'AdventureWorks2022';

-- Disable the publication database.
USE [AdventureWorks2022]
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

アクセス許可

sysadmin固定サーバー ロールのメンバーのみがsp_dropdistributiondbを実行できます。