Поделиться через


sp_dropdistpublisher (Transact-SQL)

Область применения: SQL Server Управляемый экземпляр SQL Azure

Удаляет распространяющего издателя. Эта хранимая процедура выполняется на распространителе в любой базе данных.

Соглашения о синтаксисе Transact-SQL

Синтаксис

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

Аргументы

[ @publisher = ] N'publisher'

Издатель, который нужно удалить. @publisher — sysname без значения по умолчанию.

Примечание.

Использование пользовательского порта для издателя SQL Server появилось в SQL Server 2019 (15.x). Если издатель 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

Разрешения

Могут выполняться sp_dropdistpublisherтолько члены предопределенных ролей сервера sysadmin.