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

S’APPLIQUE À : ouiSQL Server nonAzure SQL Database nonAzure SQL Data Warehouse nonParallel Data Warehouse APPLIES TO: yesSQL Server noAzure SQL Database noAzure SQL Data Warehouse noParallel Data Warehouse

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 de 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' Est le nom de la publication à supprimer.[ @publication = ] 'publication' Is the name of the publication to drop. publication est sysname, sans valeur par défaut.publication is sysname, with no default. Si tous les, toutes les publications de fusion existantes sont supprimées, ainsi que le travail de l’Agent d’instantané qui s’y rapportent.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 publication, seuls cette publication et son travail d’Agent de capture instantanée 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_distributor Utilisé pour 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 bits, avec une valeur par défaut 0.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 = ] reserved est réservé pour une utilisation ultérieure.[ @reserved = ] reserved Is reserved for future use. réservé est bits, avec une valeur par défaut 0.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.

Valeurs des codes de retourReturn Code Values

0 (réussite) ou 1 (échec)0 (success) or 1 (failure)

NotesRemarks

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

sp_dropmergepublication supprime tous les articles associés à une publication de manière récursive et 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 Delete a Push Subscription et Delete a Pull Subscription.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 ou 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 <objet > pour supprimer ces objets manuellement 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 de la sysadmin rôle serveur fixe ou le db_owner rôle de base de données fixe 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)