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


sp_dropdistributor (Transact-SQL)

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

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

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

Синтаксис

sp_dropdistributor
    [ [ @no_checks = ] no_checks ]
    [ , [ @ignore_distributor = ] ignore_distributor ]
[ ; ]

Аргументы

[ @no_checks = ] no_checks

Показывает, нужно ли проверять зависимые объекты перед удалением распространителя. @no_checks бит с значением по умолчанию0.

  • Если 0, sp_dropdistributor убедитесь, что все объекты публикации и распространения были удалены в дополнение к распространителю.

  • Если 1перед sp_dropdistributor удалением распространителя удалите все объекты публикации и распространения.

[ @ignore_distributor = ] ignore_distributor

Указывает, исполняется ли данная хранимая процедура без подключения к распространителю. @ignore_distributor имеет значение по умолчанию0.

  • Если 0, sp_dropdistributor подключитесь к распространителю и удаляет все объекты репликации. Если sp_dropdistributor не удается подключиться к распространителю, хранимая процедура завершается ошибкой.

  • Если 1подключение к распространителю не выполняется, а объекты репликации не удаляются. Этот параметр используется, если распространитель удаляется или находится в автономном режиме. Объекты для этого издателя на распространителю не удаляются, пока распространитель не будет переустановлен в некоторое время.

Значения кода возврата

0 (успешно) или 1 (сбой).

Замечания

sp_dropdistributor используется во всех типах репликации.

Если на сервере существуют другие объекты издателя или распространителя, завершается ошибкой, sp_dropdistributor если не задано 1значение @no_checks.

Эта хранимая процедура должна выполняться после удаления базы данных распространителя путем 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'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_dropdistributorтолько члены предопределенных ролей сервера sysadmin.