sp_dropmergepublication (Transact-SQL)sp_dropmergepublication (Transact-SQL)

S’applique à :Applies to: oui SQL ServerSQL Server (toutes les versions prises en charge)yesSQL ServerSQL Server (all supported versions) S’applique à :Applies to: oui SQL ServerSQL Server (toutes les versions prises en charge)yesSQL ServerSQL Server (all supported versions)

Supprime une publication de fusion et l'Agent d'instantané qui lui est associé.Drops a merge publication and its associated Snapshot Agent. Tous les abonnements doivent être supprimés avant de supprimer une publication de fusion.All subscriptions must be dropped before dropping a merge 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 du lien de rubrique Conventions de la syntaxe Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SyntaxeSyntax

  
sp_dropmergepublication [ @publication= ] 'publication'   
    [ , [ @ignore_distributor = ] ignore_distributor ]   
    [ , [ @reserved = ] reserved ]  
    [ , [ @ignore_merge_metadata = ] ignore_merge_metadata ]  

ArgumentsArguments

[ @publication = ] 'publication'Nom de la publication à supprimer.[ @publication = ] 'publication' Is the name of the publication to drop. publication est de type sysname, sans valeur par défaut.publication is sysname, with no default. Si toutest le cas, toutes les publications de fusion existantes sont supprimées, ainsi que le travail agent d’instantané qui leur est associé.If all, all existing merge publications are removed as well as the Snapshot Agent job associated with them. Si vous spécifiez une valeur particulière pour la publication, seule la publication et le travail de agent d’instantané associé sont supprimés.If you specify a particular value for publication, only that publication and its associated Snapshot Agent job are dropped.

[ @ignore_distributor = ] ignore_distributorPermet de supprimer une publication sans effectuer de tâches de nettoyage sur le serveur de distribution.[ @ignore_distributor = ] ignore_distributor Used to drop a publication without doing cleanup tasks at the Distributor. ignore_distributor est de bit, avec 0comme valeur par défaut.ignore_distributor is bit, with a default of 0. Ce paramètre est également utilisé lors de la réinstallation du serveur de distribution.This parameter is also used when reinstalling the Distributor.

[ @reserved = ] reservedEst réservé pour une utilisation ultérieure.[ @reserved = ] reserved Is reserved for future use. la valeur réservée est de bit, avec 0comme valeur par défaut.reserved is bit, with a default of 0.

[ @ignore_merge_metadata = ] ignore_merge_metadataÀ usage interne uniquement.[ @ignore_merge_metadata = ] ignore_merge_metadata Internal use only.

Codet de retourReturn Code Values

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

RemarquesRemarks

sp_dropmergepublication est utilisé dans la réplication de fusion.sp_dropmergepublication is used in merge replication.

sp_dropmergepublication supprime de manière récursive tous les articles associés à une publication, puis supprime la publication elle-même.sp_dropmergepublication recursively drops all articles that are 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_dropmergepublication 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_dropmergepublication to drop a publication does not remove published objects from the publication database or the corresponding objects from the subscription database. Utilisez DROP <object> pour supprimer manuellement ces objets, si nécessaire.Use DROP <object> to remove these objects manually if necessary.

ExempleExample

DECLARE @publication AS sysname
DECLARE @publicationDB    AS sysname
SET @publication = N'AdvWorksSalesOrdersMerge' 
SET @publicationDB = N'AdventureWorks'

-- Remove the merge publication.
USE [AdventureWorks]
EXEC sp_dropmergepublication @publication = @publication;

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

AutorisationsPermissions

Seuls les membres du rôle serveur fixe sysadmin ou du rôle de base de données fixe db_owner peuvent exécuter sp_dropmergepublication.Only members of the sysadmin fixed server role or the db_owner fixed database role can execute sp_dropmergepublication.

Voir aussiSee Also

Supprimer une publication Delete a Publication
sp_addmergepublication (Transact-SQL) sp_addmergepublication (Transact-SQL)
sp_changemergepublication (Transact-SQL) sp_changemergepublication (Transact-SQL)
sp_helpmergepublication (Transact-SQL) sp_helpmergepublication (Transact-SQL)
Procédures stockées de réplication (Transact-SQL)Replication Stored Procedures (Transact-SQL)