sp_dropdistributiondb (Transact-SQL)
删除分发数据库。 如果数据库使用的物理文件未由另一个数据库使用,则删除这些文件。 此存储过程在分发服务器上对任何数据库执行。
语法
sp_dropdistributiondb [ @database= ] 'database'
参数
- [ @database=] 'database'
要删除的数据库。database 的数据类型为 sysname,无默认值。
返回代码值
0(成功)或 1(失败)
注释
sp_dropdistributiondb 在所有类型的复制中使用。
必须先执行 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
权限
只有 sysadmin 固定服务器角色成员才能执行 sp_dropdistributiondb。