sp_dropmergepublication (Transact-SQL)
S'applique à : SQL Server
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.
Conventions de la syntaxe Transact-SQL
Syntaxe
sp_dropmergepublication
[ @publication = ] N'publication'
[ , [ @ignore_distributor = ] ignore_distributor ]
[ , [ @reserved = ] reserved ]
[ , [ @ignore_merge_metadata = ] ignore_merge_metadata ]
[ ; ]
Arguments
[ @publication = ] N’publication'
Nom de la composition à supprimer. @publication est sysname, sans valeur par défaut. Si all
, toutes les publications de fusion existantes sont supprimées, ainsi que le travail de l’Agent d’instantané associé. Si vous spécifiez une valeur particulière pour @publication, seule cette publication et son travail d’Agent d’instantané associé 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 bit, avec la valeur par défaut 0
. Ce paramètre est également utilisé lors de la réinstallation du serveur de distribution.
[ @reserved = ] réservé
Réservé pour un usage futur. @reserved est bit, avec la valeur par défaut 0
.
[ @ignore_merge_metadata = ] ignore_merge_metadata
Identifié à titre d'information uniquement. Non pris en charge. La compatibilité future n'est pas garantie.
Valeurs des codes de retour
0
(réussite) or 1
(échec).
Notes
sp_dropmergepublication
est utilisé dans la réplication de fusion.
sp_dropmergepublication
Supprime de manière récursive tous les articles associés à une composition, puis supprime la composition elle-même. Une publication ne peut pas être supprimée s’il s’agit d’un ou de plusieurs abonnements. Pour plus d’informations sur la suppression d’abonnements, consultez Supprimer un abonnement Push et Supprimer un abonnement par extraction.
L’exécution 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. Utilisez DROP <object>
pour supprimer manuellement ces objets le cas échéant.
Exemples
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
autorisations
Seuls les membres du rôle serveur fixe sysadmin ou le rôle de base de données fixe db_owner peuvent s’exécuter sp_dropmergepublication
.