sp_dropdistributor (Transact-SQL)

Disinstalla il server di distribuzione. La stored procedure viene eseguita nel server di distribuzione su qualsiasi database, a eccezione del database di distribuzione.

Icona di collegamento a un argomentoConvenzioni della sintassi Transact-SQL

Sintassi

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

Argomenti

  • [ @no_checks=] no_checks
    Indica se è necessario verificare la presenza di oggetti dipendenti prima di rimuovere il server di distribuzione. no_checks è di tipo bit e il valore predefinito è 0.

    Se 0, sp_dropdistributor esegue un controllo per verificare che siano stati rimossi tutti gli oggetti di pubblicazione e distribuzione oltre al server di distribuzione.

    Se 1, sp_dropdistributor rimuove tutti gli oggetti di pubblicazione e distribuzione prima di disinstallare il server di distribuzione.

  • [ @ignore_distributor=] ignore_distributor
    Indica se questa stored procedure viene eseguita senza stabilire una connessione al server di distribuzione. ignore_distributor è di tipo bit e il valore predefinito è 0.

    Se 0, sp_dropdistributor si connette al server di distribuzione e rimuove tutti gli oggetti di replica. Se sp_dropdistributor non è in grado di stabilire la connessione al server di distribuzione, la stored procedure non viene eseguita correttamente.

    Se 1, non viene stabilita alcuna connessione al server di distribuzione e gli oggetti di replica non vengono rimossi. Questo valore viene utilizzato se è in corso la disinstallazione del server di distribuzione oppure se il server non è in linea in modo permanente. Gli oggetti per questo server di pubblicazione nel server di distribuzione vengono rimossi solo dopo la reinstallazione successiva del server di distribuzione.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Osservazioni

La stored procedure sp_dropdistributor viene utilizzata per tutti i tipi di replica.

Se nel server sono disponibili altri oggetti del server di pubblicazione o di distribuzione, sp_dropdistributor non viene eseguita correttamente, a meno che @no_checks non sia impostato su 1.

Questa stored procedure deve essere eseguita dopo l'eliminazione del database di distribuzione tramite sp_dropdistributiondb.

Esempio

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

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

Autorizzazioni

Solo i membri del ruolo predefinito del server sysadmin possono eseguire sp_dropdistributor.