sp_dropdistpublisher (Transact-SQL)

适用于SQL Server Azure SQL 托管实例

删除分发发布服务器。 此存储过程在分发服务器上的任何数据库中执行。

Transact-SQL 语法约定

语法

sp_dropdistpublisher
    [ @publisher = ] N'publisher'
    [ , [ @no_checks = ] no_checks ]
    [ , [ @ignore_distributor = ] ignore_distributor ]
[ ; ]

参数

[ @publisher = ] N'publisher'

要删除的发布服务器。 @publisher为 sysname,无默认值。

注意

SQL Server 2019(15.x)中引入了 SQL Server 发布服务器的自定义端口。 如果 SQL Server 发布服务器配置了自定义端口,则在分发服务器上删除此类发布服务器时,请提供发布服务器名称而不是 <Hostname>,<PortNumber>

[ @no_checks = ] no_checks

指定是否检查发布服务器是否已 sp_dropdistpublisher 将服务器卸载为分发服务器。 @no_checks,默认值为 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