Partage via


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) ou 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.