sp_dropdistpublisher (Transact-SQL)
ディストリビューション パブリッシャーを削除します。 このストアド プロシージャは、ディストリビューター側で任意のデータベースについて実行されます。
.gif "トピック リンク アイコン")
構文
sp_dropdistpublisher [ @publisher = ] 'publisher'
[ , [ @no_checks = ] no_checks ]
[ , [ @ignore_distributor = ] ignore_distributor ]
引数
[ @publisher= ] 'publisher'
削除するパブリッシャーを指定します。 publisher のデータ型は sysname で、既定値はありません。[ @no_checks= ] no_checks
sp_dropdistpublisher で、パブリッシャーがディストリビューターとしてサーバーをアンインストールしたことを確認するかどうかを指定します。 no_checks のデータ型は bit で、既定値は 0 です。0 の場合、レプリケーションでは、リモート パブリッシャーがディストリビューターとしてローカル サーバーをアンインストールしたことが確認されます。 パブリッシャーがローカルの場合、レプリケーションでは、ローカル サーバーにパブリケーションまたはディストリビューション オブジェクトが残っていないことが確認されます。
1 の場合、ディストリビューション パブリッシャーに関連付けられているすべてのレプリケーション オブジェクトは、リモート パブリッシャーに到達していないなくても削除されます。 この後、リモート パブリッシャーでは sp_dropdistributor に @ignore_distributor = 1 を指定して実行し、レプリケーションをアンインストールする必要があります。
[ @ignore_distributor= ] ignore_distributor
パブリッシャーが削除されるとき、ディストリビューターにディストリビューション オブジェクトを残すかどうかを指定します。 ignore_distributor のデータ型は bit で、次のいずれかの値を指定できます。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'AdventureWorks2012';
-- Disable the publication database.
USE [AdventureWorks2012]
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_dropdistpublisher を実行できるのは、sysadmin 固定サーバー ロールのメンバーだけです。
関連項目
参照
sp_adddistpublisher (Transact-SQL)
sp_changedistpublisher (Transact-SQL)
sp_helpdistpublisher (Transact-SQL)
レプリケーション ストアド プロシージャ (Transact-SQL)