sp_dropdistributor (Transact-SQL)
適用対象: 
SQL Server Azure SQL Managed Instance
ディストリビューターをアンインストールします。 このストアド プロシージャは、ディストリビューション データベースを除く任意のデータベースのディストリビューターで実行されます。
構文
sp_dropdistributor
[ [ @no_checks = ] no_checks ]
[ , [ @ignore_distributor = ] ignore_distributor ]
[ ; ]
引数
[ @no_checks = ] no_checks
ディストリビューターを削除する前に依存オブジェクトをチェックするかどうかを示します。 @no_checks は bit で、既定値は 0 です。
0場合、sp_dropdistributorは、ディストリビューターに加えて、すべてのパブリッシュ オブジェクトとディストリビューション オブジェクトが削除されたことを確認します。1場合、sp_dropdistributorはディストリビューターをアンインストールする前に、すべてのパブリッシュオブジェクトとディストリビューション オブジェクトを削除します。
[ @ignore_distributor = ] ignore_distributor
ディストリビューターに接続せずにこのストアド プロシージャを実行するかどうかを示します。 @ignore_distributor は bit で、既定値は 0 です。
0場合、sp_dropdistributorはディストリビューターに接続し、すべてのレプリケーション オブジェクトを削除します。sp_dropdistributorディストリビューターに接続できない場合、ストアド プロシージャは失敗します。1場合、ディストリビューターへの接続は行われず、レプリケーション オブジェクトは削除されません。 このオプションは、ディストリビューターがアンインストールされている場合、または完全にオフラインになっている場合に使用されます。 ディストリビューター側のこのパブリッシャーのオブジェクトは、将来ディストリビューターが再インストールされるまで削除されません。
リターン コードの値
0 (成功) または 1 (失敗)。
解説
sp_dropdistributor は、すべての種類のレプリケーションで使用されます。
他のパブリッシャー オブジェクトまたはディストリビューション オブジェクトがサーバー上に存在する場合、@no_checksが 1 に設定されていない限り、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'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_dropdistributorを実行できます。