sp_dropsubscription (Transact-SQL)sp_dropsubscription (Transact-SQL)

S’APPLIQUE À : ouiSQL Server ouiAzure SQL Database (Managed Instance uniquement) nonAzure SQL Data Warehouse nonParallel Data Warehouse APPLIES TO: yesSQL Server yesAzure SQL Database (Managed Instance only) noAzure SQL Data Warehouse noParallel Data Warehouse

Supprime les abonnements relatifs à un article, une publication ou un ensemble d'abonnements particuliers sur le serveur de publication.Drops subscriptions to a particular article, publication, or set of subscriptions on the Publisher. 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_dropsubscription [ [ @publication= ] 'publication' ]  
    [ , [ @article= ] 'article' ]  
        , [ @subscriber= ] 'subscriber'  
    [ , [ @destination_db= ] 'destination_db' ]  
    [ , [ @ignore_distributor = ] ignore_distributor ]  
    [ , [ @reserved= ] 'reserved' ]  

ArgumentsArguments

[ @publication = ] 'publication'Nom de la publication associée.[ @publication = ] 'publication' Is the name of the associated publication. publication est de type sysname, avec NULL comme valeur par défaut.publication is sysname, with a default of NULL. Si la totalitéest, tous les abonnements de toutes les publications de l’abonné spécifié sont annulés.If all, all subscriptions for all publications for the specified Subscriber are canceled. la publication est un paramètre obligatoire.publication is a required parameter.

[ @article = ] 'article'Nom de l’article.[ @article = ] 'article' Is the name of the article. article est de type sysname, avec NULL comme valeur par défaut.article is sysname, with a default value of NULL. Si la valeur est All, les abonnements à tous les articles pour chaque publication et abonné spécifiés sont supprimés.If all, subscriptions to all articles for each specified publication and Subscriber are dropped. Utilisez All pour les publications qui autorisent la mise à jour immédiate.Use all for publications that allow immediate updating.

[ @subscriber = ] 'subscriber'Nom de l’abonné dont les abonnements seront supprimés.[ @subscriber = ] 'subscriber' Is the name of the Subscriber that will have its subscriptions dropped. Subscriber est de type sysname, sans valeur par défaut.subscriber is sysname, with no default. Si la totalitéest, tous les abonnements de tous les abonnés sont supprimés.If all, all subscriptions for all Subscribers are dropped.

[ @destination_db = ] 'destination_db'Nom de la base de données de destination.[ @destination_db = ] 'destination_db' Is the name of the destination database. destination_db est de type sysname, avec NULL comme valeur par défaut.destination_db is sysname, with a default of NULL. Si la valeur est NULL, tous les abonnements de cet Abonné seront supprimés.If NULL, all the subscriptions from that Subscriber are dropped.

[ @ignore_distributor = ] ignore_distributor

Identifié à titre d'information uniquement.Identified for informational purposes only. Non pris en charge.Not supported. La compatibilité future n'est pas garantie.Future compatibility is not guaranteed.

[ @reserved = ] 'reserved'

Identifié à titre d'information uniquement.Identified for informational purposes only. Non pris en charge.Not supported. La compatibilité future n'est pas garantie.Future compatibility is not guaranteed.

Valeurs des codes de retourReturn Code Values

0 (succès) ou 1 (échec)0 (success) or 1 (failure)

NotesRemarks

sp_dropsubscription est utilisé dans la réplication transactionnelle et d’instantané.sp_dropsubscription is used in snapshot and transactional replication.

Si vous supprimez l'abonnement à un article dans une publication à synchronisation immédiate, vous ne pourrez le rajouter que si vous supprimez les abonnements relatifs à tous les articles de la publication et que vous les rajoutez tous en même temps.If you drop the subscription on an article in an immediate-sync publication, you cannot add it back unless you drop the subscriptions on all the articles in the publication and add them all back at once.

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 transactional publication.
DECLARE @publication AS sysname;
DECLARE @subscriber AS sysname;
SET @publication = N'AdvWorksProductTran';
SET @subscriber = $(SubServer);

USE [AdventureWorks2012]
EXEC sp_dropsubscription 
  @publication = @publication, 
  @article = N'all',
  @subscriber = @subscriber;
GO

AutorisationsPermissions

Seuls les membres du rôle serveur fixe sysadmin , du rôle de base de données fixe db_owner ou de l’utilisateur qui a créé l’abonnement peuvent exécuter sp_dropsubscription.Only members of the sysadmin fixed server role, the db_owner fixed database role, or the user that created the subscription can execute sp_dropsubscription.

Voir aussiSee Also

Supprimer un abonnement par envoi de notification Delete a Push Subscription
sp_addsubscription (Transact-SQL) sp_addsubscription (Transact-SQL)
sp_changesubstatus (Transact-SQL) sp_changesubstatus (Transact-SQL)
sp_helpsubscription (Transact-SQL)sp_helpsubscription (Transact-SQL)