sp_dropdistributor (Transact-SQL)

Aplica-se a: Instância Gerenciada de SQL do Azure do SQL Server

Desinstala o Distribuidor. Esse procedimento armazenado é executado no Distribuidor ou em qualquer banco de dados, exceto no banco de dados de distribuição.

Convenções de sintaxe de Transact-SQL

Sintaxe

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

Argumentos

@no_checks [ = ] no_checks

Indica se os objetos dependentes devem ser verificados antes da remoção do Distribuidor. @no_checks é bit, com um padrão de 0.

  • Se 0, sp_dropdistributor verifica se todos os objetos de publicação e distribuição foram descartados, além do Distribuidor.

  • Se 1, sp_dropdistributor descarta todos os objetos de publicação e distribuição antes de desinstalar o distribuidor.

@ignore_distributor [ = ] ignore_distributor

Indica se esse procedimento armazenado será executado sem se conectar ao Distribuidor. @ignore_distributor é bit, com um padrão de 0.

  • Se 0, sp_dropdistributor conecta-se ao Distribuidor e remove todos os objetos de replicação. Se sp_dropdistributor não for possível se conectar ao Distribuidor, o procedimento armazenado falhará.

  • Se 1, nenhuma conexão for feita com o Distribuidor e os objetos de replicação não serão removidos. Essa opção será usada se o Distribuidor estiver sendo desinstalado ou estiver permanentemente offline. Os objetos desse Publicador no Distribuidor não são removidos até que o Distribuidor seja reinstalado em algum momento futuro.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Comentários

sp_dropdistributor é usado em todos os tipos de replicação.

Se existirem outros objetos do Publicador ou de distribuição no servidor, falhará, sp_dropdistributor a menos que @no_checks esteja definido como 1.

Esse procedimento armazenado deve ser executado após descartar o banco de dados de distribuição executando sp_dropdistributiondbo .

Exemplos

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

Permissões

Somente membros da função de servidor fixa sysadmin podem executar sp_dropdistributor.