sp_dropdistpublisher (Transact-SQL)
適用対象: 
SQL Server Azure SQL Managed Instance
ディストリビューションパブリッシャーを削除します。 このストアド プロシージャは、任意のデータベースのディストリビューターで実行されます。
構文
sp_dropdistpublisher
[ @publisher = ] N'publisher'
[ , [ @no_checks = ] no_checks ]
[ , [ @ignore_distributor = ] ignore_distributor ]
[ ; ]
引数
[ @publisher = ] N'publisher'
ドロップするパブリッシャー。 @publisher は sysname で、既定値はありません。
Note
SQL Server パブリッシャーのカスタム ポートの使用は、SQL Server 2019 (15.x) で導入されました。 SQL Server パブリッシャーがカスタム ポートで構成されている場合は、ディストリビューターでこのようなパブリッシャーを削除するときに、 <Hostname>,<PortNumber>ではなくパブリッシャー サーバー名を指定します。
[ @no_checks = ] no_checks
パブリッシャーがディストリビューターとしてサーバーをアンインストールしたことを sp_dropdistpublisher チェックするかどうかを指定します。 @no_checks は bit で、既定値は 0 です。
0場合、レプリケーションは、リモート パブリッシャーがローカル サーバーをディストリビューターとしてアンインストールしたことを確認します。 パブリッシャーがローカルの場合、レプリケーションでは、ローカル サーバーにパブリケーション オブジェクトまたはディストリビューション オブジェクトが残っていないかどうかが確認されます。1場合、リモート パブリッシャーに到達できない場合でも、ディストリビューション パブリッシャーに関連付けられているすべてのレプリケーション オブジェクトが削除されます。 これを行った後、リモート パブリッシャーは、@ignore_distributor = 1でsp_dropdistributorを使用してレプリケーションをアンインストールする必要があります。
[ @ignore_distributor = ] ignore_distributor
パブリッシャーが削除されるとき、ディストリビューターにディストリビューション オブジェクトを残すかどうかを指定します。 @ignore_distributor は ビットであり、次のいずれかの値を指定できます。
1= @publisher に属するディストリビューション オブジェクトはディストリビューターに残ります。0= @publisher のディストリビューション オブジェクトはディストリビューターでクリーンアップされます。
リターン コードの値
0 (成功) または 1 (失敗)。
解説
sp_dropdistpublisher は、すべての種類のレプリケーションで使用されます。
Oracle パブリッシャーを削除すると、パブリッシャーを削除できない場合、 sp_dropdistpublisher はエラーを返し、パブリッシャーのディストリビューター オブジェクトは削除されます。
例
-- 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_dropdistpublisherを実行できます。