Share via

  • [アーティクル]

sp_dropdistpublisher (Transact-SQL)

ディストリビューション パブリッシャを削除します。このストアド プロシージャは、任意のデータベース上のディストリビュータ側で実行されます。

トピック リンク アイコンTransact-SQL 構文表記規則

構文

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

-- Disable the publication database.
USE [AdventureWorks]
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 固定サーバー ロールのメンバだけです。