sp_dropdistpublisher (Transact-SQL)

  • [アーティクル]

適用対象: SQL ServerAzure SQL Managed Instance

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

Transact-SQL 構文表記規則

構文

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_チェック

パブリッシャーがディストリビューターとしてサーバーをアンインストールしたチェックかどうかをsp_dropdistpublisher指定します。 @no_チェックはビットで、既定値は 0.

  • 場合 0、レプリケーションは、リモート パブリッシャーがディストリビューターとしてローカル サーバーをアンインストールしたことを確認します。 パブリッシャーがローカルの場合、レプリケーションでは、ローカル サーバー上にパブリケーション オブジェクトまたはディストリビューション オブジェクトが再メインされていないことが確認されます。

  • この場合 1、リモート パブリッシャーに到達できない場合でも、ディストリビューション パブリッシャーに関連付けられているすべてのレプリケーション オブジェクトが削除されます。 この操作を行った後、リモート パブリッシャーは、... でsp_dropdistributor@ignore_distributor = 1を使用してレプリケーションをアンインストールする必要があります。

[ @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できます。

関連するコンテンツ