sp_dropmergesubscription (Transact-SQL)sp_dropmergesubscription (Transact-SQL)

S’APPLIQUE À : ouiSQL Server nonAzure SQL Database nonAzure Synapse Analytics (SQL DW) nonParallel Data Warehouse APPLIES TO: yesSQL Server noAzure SQL Database noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse

Supprime un abonnement à une publication de fusion et à l'Agent de fusion qui lui est associé.Drops a subscription to a merge publication and its associated Merge Agent. 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_dropmergesubscription [ [ @publication= ] 'publication' ]   
    [ , [ @subscriber= ] 'subscriber'    
    [ , [ @subscriber_db= ] 'subscriber_db' ]   
    [ , [ @subscription_type= ] 'subscription_type' ]   
    [ , [ @ignore_distributor = ] ignore_distributor ]   
    [ , [ @reserved = ] reserved ]  

ArgumentsArguments

[ @publication = ] 'publication' Est le nom de la publication.[ @publication = ] 'publication' Is the publication name. publication est sysname, avec NULL comme valeur par défaut.publication is sysname, with a default of NULL. La publication doit déjà exister et se conformer aux règles des identificateurs.The publication must already exist and conform to the rules for identifiers.

[ @subscriber = ] 'subscriber' Est le nom de l’abonné.[ @subscriber = ] 'subscriber' Is the name of the Subscriber. abonné est sysname, avec NULL comme valeur par défaut.subscriber is sysname, with a default of NULL.

[ @subscriber_db = ] 'subscriber_db' Est le nom de la base de données d’abonnement.[ @subscriber_db = ] 'subscriber_db' Is the name of the subscription database. base_de_données_abonnementest sysname, avec NULL comme valeur par défaut.subscription_databaseis sysname, with a default of NULL.

[ @subscription_type = ] 'subscription_type' Est le type d’abonnement.[ @subscription_type = ] 'subscription_type' Is the type of subscription. subscription_typeest nvarchar (15) , et peut prendre l’une des valeurs suivantes.subscription_typeis nvarchar(15), and can be one of these values.

ValueValue DescriptionDescription
allall Abonnements par envoi de données (push), par extraction de données (pull) et anonymes.Push, pull, and anonymous subscriptions
Anonymeanonymous Abonnement anonyme.Anonymous subscription.
pushpush Abonnement par envoi de données (push).Push subscription.
pullpull Abonnement par extraction de données (pull).Pull subscription.
les deux (valeur par défaut)both (default) Abonnements par envoi et extraction de données.Both push and pull subscriptions.

[ @ignore_distributor = ] ignore_distributor Indique si cette procédure stockée est exécutée sans se connecter au serveur de distribution.[ @ignore_distributor = ] ignore_distributor Indicates whether this stored procedure is executed without connecting to 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 peut être utilisé pour supprimer un abonnement sans effectuer de tâches de nettoyage sur le serveur de distribution.This parameter can be used to drop a subscription without doing cleanup tasks at the Distributor. Il est également utile si vous devez réinstaller le serveur de distribution.It is also useful if you had to reinstall 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.

Valeurs des codes de retourReturn Code Values

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

NotesRemarks

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

ExempleExample

-- This script uses sqlcmd scripting variables. They are in the form
-- $(MyVariable). For information about how to use scripting variables  
-- on the command line and in SQL Server Management Studio, see the 
-- "Executing Replication Scripts" section in the topic
-- "Programming Replication Using System Stored Procedures".

-- This batch is executed at the Publisher to remove 
-- a pull or push subscription to a merge publication.
DECLARE @publication AS sysname;
DECLARE @subscriber AS sysname;
DECLARE @subscriptionDB AS sysname;
SET @publication = N'AdvWorksSalesOrdersMerge';
SET @subscriber = $(SubServer);
SET @subscriptionDB = N'AdventureWorks2012Replica';

USE [AdventureWorks2012]
EXEC sp_dropmergesubscription 
  @publication = @publication, 
  @subscriber = @subscriber, 
  @subscriber_db = @subscriptionDB;
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_dropmergesubscription.Only members of the sysadmin fixed server role or the db_owner fixed database role can execute sp_dropmergesubscription.

Voir aussiSee Also

Supprimer un abonnement envoyé Delete a Push Subscription
Supprimer un abonnement par extraction Delete a Pull Subscription
sp_addmergesubscription (Transact-SQL) sp_addmergesubscription (Transact-SQL)
sp_changemergesubscription (Transact-SQL) sp_changemergesubscription (Transact-SQL)
sp_helpmergesubscription (Transact-SQL)sp_helpmergesubscription (Transact-SQL)