sp_dropdistributiondb (Transact-SQL)sp_dropdistributiondb (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

Supprime une base de données de distribution.Drops a distribution database. Supprime les fichiers physiques utilisés par la base de données s'ils ne sont pas utilisés par une autre base de données.Drops the physical files used by the database if they are not used by another database. Cette procédure stockée est exécutée sur n’importe quelle base de données du serveur de distribution.This stored procedure is executed at the Distributor on any database.

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

SyntaxeSyntax

  
sp_dropdistributiondb [ @database= ] 'database'  

ArgumentsArguments

[ @database = ] 'database'Base de données à supprimer.[ @database = ] 'database' Is the database to drop. Database est de type sysname, sans valeur par défaut.database is sysname, with no default.

Valeurs des codes de retourReturn Code Values

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

NotesRemarks

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

Cette procédure stockée doit être exécutée avant de supprimer le serveur de distribution en exécutant sp_dropdistributor.This stored procedure must be executed before dropping the Distributor by executing sp_dropdistributor.

sp_dropdistributiondb supprime également un travail agent de lecture de la file d’attente pour la base de données de distribution, le cas échéant.sp_dropdistributiondb also removes a Queue Reader Agent job for the distribution database, if one exists.

Pour désactiver la distribution, la base de données remplissant cette fonction doit se trouver en ligne.To disable distribution, the distribution database must be online. Également, si un instantané existe pour la base de données de distribution, elle doit être supprimée avant la désactivation de la distribution.If a database snapshot exists for the distribution database, it must be dropped before disabling distribution. Un instantané de base de données est une copie en lecture seule hors ligne d'une base de données et n'est pas lié à un instantané de réplication.A database snapshot is a read-only offline copy of a database, and is not related to a replication snapshot. Pour plus d’informations, consultez Instantanés de base de données (SQL Server).For more information, see Database Snapshots (SQL Server).

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_dropdistributiondb.Only members of the sysadmin fixed server role can execute sp_dropdistributiondb.

Voir aussiSee Also

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