sp_dropdistributor (Transact-SQL)

项目
05/08/2013

卸载分发服务器。此存储过程在分发服务器上除分发数据库之外的任何数据库中执行。

语法

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_checks 设置为 1，否则，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