sp_dropdistributor (Transact-SQL)

Artículo
05/08/2013

Desinstala el distribuidor. Este procedimiento almacenado se ejecuta en el distribuidor de cualquier base de datos, excepto la de distribución.

Icono de vínculo a temas Convenciones de sintaxis de Transact-SQL

Sintaxis

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

Argumentos

[ @no_checks=] no_checks
Indica si se comprobará si existen objetos dependientes antes de quitar el distribuidor. no_checks es de tipo bit y su valor predeterminado es 0.

Si el valor es 0, sp_dropdistributor comprueba que se hayan quitado todos los objetos de publicación y distribución, además del distribuidor.

Si el valor es 1, sp_dropdistributor quita todos los objetos de publicación y distribución antes de desinstalar el distribuidor.
[ @ignore_distributor=] ignore_distributor
Indica si este procedimiento almacenado se ejecuta sin conectarse al distribuidor. ignore_distributor es de tipo bit y su valor predeterminado es 0.

Si el valor es 0, sp_dropdistributor se conecta al distribuidor y quita todos los objetos de replicación. Si sp_dropdistributor no puede conectarse al distribuidor, se produce un error en el procedimiento almacenado.

Si el valor es 1, no se establece conexión con el distribuidor y no se quitan los objetos de replicación. Esta opción se utiliza cuando el distribuidor se va a desinstalar o cuando está permanentemente sin conexión. Los objetos de este publicador en el distribuidor no se quitan hasta que se vuelva a instalar el distribuidor.

Valores de código de retorno

0 (correcto) o 1 (error)

Comentarios

sp_dropdistributor se usa en todos los tipos de replicación.

Si en el servidor hay otro publicador u objetos de distribución, se produce un error en sp_dropdistributor a menos que @no_checks se establezca en 1..

Este procedimiento almacenado se debe ejecutar después de quitar la base de datos de distribución con sp_dropdistributiondb.

Ejemplo

-- 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'AdventureWorks2012';

-- Disable the publication database.
USE [AdventureWorks2012]
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