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


sp_dropdistributiondb (Transact-SQL)

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

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

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

Синтаксис

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

Аргументы

[ @database = ] N'database'

База данных для удаления. @database — sysname без значения по умолчанию.

[ @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

Разрешения

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