sp_dropdistributor (Transact-SQL)sp_dropdistributor (Transact-SQL)

S’APPLIQUE À : ouiSQL Server ouiAzure SQL Database (Managed Instance uniquement) nonAzure SQL Data Warehouse nonParallel Data Warehouse APPLIES TO: yesSQL Server yesAzure SQL Database (Managed Instance only) noAzure SQL Data Warehouse noParallel Data Warehouse

Désinstalle le serveur de distribution.Uninstalls the Distributor. Cette procédure stockée est exécutée sur n'importe quelle base de données du serveur de distribution, à l'exception de la base de données de distribution.This stored procedure is executed at the Distributor on any database except the distribution database.

Icône de lien de rubrique Conventions de la syntaxe Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SyntaxeSyntax

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

ArgumentsArguments

[ @no_checks = ] no_checksIndique s’il faut vérifier les objets dépendants avant de supprimer le serveur de distribution.[ @no_checks = ] no_checks Indicates whether to check for dependent objects before dropping the Distributor. no_checks est de valeur de bit, avec 0 comme valeur par défaut.no_checks is bit, with a default of 0.

Si la valeur est 0, sp_dropdistributor s’assure que tous les objets de publication et de distribution en plus du serveur de distribution ont été supprimés.If 0, sp_dropdistributor checks to make sure that all publishing and distribution objects in addition to the Distributor have been dropped.

Si la valeur est 1, sp_dropdistributor supprime tous les objets de publication et de distribution avant de désinstaller le serveur de distribution.If 1, sp_dropdistributor drops all the publishing and distribution objects prior to uninstalling the distributor.

[ @ignore_distributor = ] ignore_distributorIndique si cette procédure stockée est exécutée sans se connecter au serveur de distribution.[ @ignore_distributor = ] ignore_distributor Indicates whether this stored procedure is executed without connecting to the Distributor. ignore_distributor est de valeur de bit, avec 0comme valeur par défaut.ignore_distributor is bit, with a default of 0.

Si la valeur est 0, sp_dropdistributor se connecte au serveur de distribution et supprime tous les objets de réplication.If 0, sp_dropdistributor connects to the Distributor and removes all replication objects. Si sp_dropdistributor ne parvient pas à se connecter au serveur de distribution, la procédure stockée échoue.If sp_dropdistributor is unable to connect to the Distributor, the stored procedure fails.

Si la valeur est 1, aucune connexion n’est établie avec le serveur de distribution et les objets de réplication ne sont pas supprimés.If 1, no connection is made to the Distributor and the replication objects are not removed. Cette option est utilisée lors de la désinstallation du serveur de distribution ou lorsque celui-ci est mis hors ligne de façon permanente.This is used if the Distributor is being uninstalled or is permanently offline. Les objets de ce serveur de publication sur le serveur de distribution seront supprimés uniquement lors d'une réinstallation ultérieure du serveur de distribution.The objects for this Publisher at the Distributor are not removed until the Distributor is reinstalled at some future time.

Valeurs des codes de retourReturn Code Values

0 (succès) ou 1 (échec)0 (success) or 1 (failure)

NotesRemarks

sp_dropdistributor est utilisé dans tous les types de réplications.sp_dropdistributor is used in all types of replication.

Si d’autres objets de publication ou de distribution existent sur le serveur, **@no_checks** sp_dropdistributor échoue, sauf si a la valeur 1.If other Publisher or distribution objects exist on the server, sp_dropdistributor fails unless **@no_checks** is set to 1.

Cette procédure stockée doit être exécutée après la suppression de la base de données de distribution en exécutant sp_dropdistributiondb.This stored procedure must be executed after dropping the distribution database by executing sp_dropdistributiondb.

ExempleExample

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

AutorisationsPermissions

Seuls les membres du rôle serveur fixe sysadmin peuvent exécuter sp_dropdistributor.Only members of the sysadmin fixed server role can execute sp_dropdistributor.

Voir aussiSee Also

Désactiver la publication et la distribution Disable Publishing and Distribution
sp_adddistributor (Transact-SQL) sp_adddistributor (Transact-SQL)
sp_changedistributor_property (Transact-SQL) sp_changedistributor_property (Transact-SQL)
sp_helpdistributor (Transact-SQL) sp_helpdistributor (Transact-SQL)
Procédures stockées de réplication (Transact-SQL)Replication Stored Procedures (Transact-SQL)