sp_droppublication (Transact-SQL)sp_droppublication (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 publication et l'Agent d'instantané qui lui est associé.Drops a publication and its associated Snapshot Agent. Tous les abonnements doivent être supprimés avant de pouvoir supprimer une publication.All subscriptions must be dropped before dropping a publication. Les articles de la publication sont supprimés automatiquement.The articles in the publication are dropped automatically. Cette procédure stockée est exécutée sur le serveur de publication dans la base de données de publication.This stored procedure is executed at the Publisher on the publication database.

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

SyntaxeSyntax

  
sp_droppublication [ @publication= ] 'publication'   
    [ , [ @ignore_distributor = ] ignore_distributor ]  

ArgumentsArguments

[ @publication = ] 'publication'Nom de la publication à supprimer.[ @publication = ] 'publication' Is the name of the publication to be dropped. publication est de type sysname, sans valeur par défaut.publication is sysname, with no default. Si All est spécifié, toutes les publications sont supprimées de la base de données de publication, à l’exception de celles qui ont des abonnements.If all is specified, all publications are dropped from the publication database, except for those with subscriptions.

[ @ignore_distributor = ] ignore_distributor Identifié à titre d'information uniquement.Identified for informational purposes only. Non pris en charge.Not supported. La compatibilité future n'est pas garantie.Future compatibility is not guaranteed.[ @ignore_distributor = ] ignore_distributor Identifié à titre d'information uniquement.Identified for informational purposes only. Non pris en charge.Not supported. La compatibilité future n'est pas garantie.Future compatibility is not guaranteed.

Valeurs des codes de retourReturn Code Values

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

NotesRemarks

sp_droppublication est utilisé dans la réplication d’instantané et la réplication transactionnelle.sp_droppublication is used in snapshot replication and transactional replication.

sp_droppublication supprime de manière récursive tous les articles associés à une publication, puis supprime la publication elle-même.sp_droppublication recursively drops all articles associated with a publication and then drops the publication itself. Une publication ne peut être supprimée si elle fait l'objet d'un ou de plusieurs abonnements.A publication cannot be removed if it has one or more subscriptions to it. Pour plus d’informations sur la suppression des abonnements, consultez supprimer un abonnement par émission de données et supprimer un abonnement par extraction.For information about how to remove subscriptions, see Delete a Push Subscription and Delete a Pull Subscription.

L’exécution de sp_droppublication pour supprimer une publication ne supprime pas les objets publiés de la base de données de publication ni les objets correspondants de la base de données d’abonnement.Executing sp_droppublication to drop a publication does not remove published objects from the publication database or the corresponding objects from the subscription database. Utilisez l' > de suppression d' objetpoursupprimercesobjetsmanuellementsinécessaire.<Use DROP <object> to remove these objects manually if necessary.

AutorisationsPermissions

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

ExemplesExamples

DECLARE @publicationDB AS sysname;
DECLARE @publication AS sysname;
SET @publicationDB = N'AdventureWorks'; 
SET @publication = N'AdvWorksProductTran'; 

-- Remove a transactional publication.
USE [AdventureWorks2012]
EXEC sp_droppublication @publication = @publication;

-- Remove replication objects from the database.
USE [master]
EXEC sp_replicationdboption 
  @dbname = @publicationDB, 
  @optname = N'publish', 
  @value = N'false';
GO

Voir aussiSee Also

Supprimer une publication Delete a Publication
sp_addpublication (Transact-SQL) sp_addpublication (Transact-SQL)
sp_changepublication (Transact-SQL) sp_changepublication (Transact-SQL)
sp_helppublication (Transact-SQL) sp_helppublication (Transact-SQL)
Procédures stockées de réplication (Transact-SQL)Replication Stored Procedures (Transact-SQL)