sp_dropmergepublication (Transact-SQL)

Article
05/07/2013

Supprime une publication de fusion et l'Agent d'instantané qui lui est associé. Tous les abonnements doivent être supprimés avant de supprimer une publication de fusion. Les articles de la publication sont supprimés automatiquement. Cette procédure stockée est exécutée sur le serveur de publication dans la base de données de publication.

Icône Lien de rubrique Conventions de la syntaxe de Transact-SQL

Syntaxe

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

Arguments

[ @publication=] 'publication'
Nom de la publication à supprimer. publication est de type sysname et n'a pas de valeur par défaut. Si la valeur est all, toutes les publications de fusion sont supprimées, de même que le travail d'Agent d'instantané associé à celles-ci. Si vous spécifiez une valeur particulière pour publication, seuls cette publication et le travail d'Agent d'instantané associé à celle-ci sont supprimés.
[ @ignore_distributor =] ignore_distributor
Permet de supprimer une publication sans effectuer de tâches de nettoyage au niveau du serveur de distribution. ignore_distributor est de type bit, avec 0 comme valeur par défaut. Ce paramètre est également utilisé lors de la réinstallation du serveur de distribution.
[ @reserved=] reserved
Elle est réservée pour un usage futur. reserved est de type bit, avec 0 comme valeur par défaut.
[ @ignore_merge_metadata= ] ignore_merge_metadata
À usage interne uniquement.

Valeurs des codes de retour

0 (succès) ou 1 (échec)

Notes

La procédure sp_dropmergepublication est utilisée dans la réplication de fusion.

sp_dropmergepublication supprime de manière récursive tous les articles associés à une publication, puis supprime la publication en elle-même. Une publication ne peut être supprimée si elle fait l'objet d'un ou de plusieurs abonnements. Pour plus d'informations sur la suppression des abonnements, consultez Supprimer un abonnement par émission (push) et Supprimer un abonnement par extraction (pull).

L'exécution de sp_dropmergepublication pour supprimer une publication n'entraîne pas la suppression des objets publiés de la base de données de publication ou des objets correspondants de la base de données d'abonnement. Si nécessaire, utilisez DROP <objet> pour supprimer manuellement ces objets.

Exemple

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