sp_dropdistributiondb (Transact-SQL)

适用于SQL Server Azure SQL 托管实例

删除分发数据库。 如果数据库未使用物理文件,则删除该数据库使用的物理文件。 此存储过程在分发服务器上的任何数据库中执行。

Transact-SQL 语法约定

语法

sp_dropdistributiondb
    [ @database = ] N'database'
    [ , [ @former_ag_secondary = ] former_ag_secondary ]
[ ; ]

参数

[ @database = ] N'database'

要删除的数据库。 @databasesysname,无默认值。

[ @former_ag_secondary = ] former_ag_secondary

指定此节点是否以前是分发数据库可用性组的一部分。 @former_ag_secondary为 int,默认值为 0.

返回代码值

0(成功)或 1(失败)。

注解

sp_dropdistributiondb 用于所有类型的复制。

必须先执行此存储过程,然后才能通过执行 sp_dropdistributor来删除分发服务器。

sp_dropdistributiondb 如果存在队列读取器代理作业,则还会删除分发数据库的队列读取器代理作业。

要禁用分发,分发数据库必须联机。 如果存在分发数据库的数据库快照,必须在禁用分发之前删除该快照。 数据库快照是数据库的只读脱机副本,与复制快照无关。 有关详细信息,请参阅数据库快照(SQL Server)。

示例

-- 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_dropdistributiondb