sp_dropdistributor (Transact-SQL)

ディストリビューターをアンインストールします。 このストアド プロシージャは、ディストリビューター側でディストリビューション データベースを除くすべてのデータベースについて実行されます。

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

構文

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_checks1 に設定されていない限り、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'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_dropdistributor を実行できるのは、sysadmin 固定サーバー ロールのメンバーだけです。

関連項目

参照

sp_adddistributor (Transact-SQL)

sp_changedistributor_property (Transact-SQL)

sp_helpdistributor (Transact-SQL)

レプリケーション ストアド プロシージャ (Transact-SQL)

概念

パブリッシングおよびディストリビューションの無効化