项目
12/14/2010

sp_dropdistributor (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_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'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