sp_dropsubscription (Transact-SQL)

S’applique à : SQL Server (toutes les versions prises en charge) Azure SQL Managed Instance

Supprime les abonnements relatifs à un article, une publication ou un ensemble d'abonnements particuliers sur le serveur de publication. Cette procédure stockée est exécutée sur le serveur de publication dans la base de données de publication.

Topic link iconConventions de la syntaxe Transact-SQL

Syntaxe

  
sp_dropsubscription [ [ @publication= ] 'publication' ]  
    [ , [ @article= ] 'article' ]  
        , [ @subscriber= ] 'subscriber'  
    [ , [ @destination_db= ] 'destination_db' ]  
    [ , [ @ignore_distributor = ] ignore_distributor ]  
    [ , [ @reserved= ] 'reserved' ]  

Arguments

[ @publication = ] 'publication' Nom de la composition associée. la publication est sysname, avec une valeur par défaut null. Si tout est possible, tous les abonnements pour toutes les publications pour l’Abonné spécifié sont annulés. la publication est un paramètre obligatoire.

[ @article = ] 'article' Nom de l’article. l’article est sysname, avec une valeur par défaut de NULL. Si tous, les abonnements à tous les articles pour chaque publication spécifiée et l’Abonné sont supprimés. Utilisez tous les publications qui autorisent la mise à jour immédiate.

[ @subscriber = ] 'subscriber' Nom de l’Abonné qui aura ses abonnements supprimés. l’abonné est sysname, sans valeur par défaut. Si tous, tous les abonnements pour tous les abonnés sont supprimés.

[ @destination_db = ] 'destination_db' Nom de la base de données de destination. destination_db est sysname, avec la valeur NULL par défaut. Si la valeur est NULL, tous les abonnements de cet Abonné seront supprimés.

[ @ignore_distributor = ] ignore_distributor

Identifié à titre d'information uniquement. Non pris en charge. La compatibilité future n'est pas garantie.

[ @reserved = ] 'reserved'

Identifié à titre d'information uniquement. Non pris en charge. La compatibilité future n'est pas garantie.

Codet de retour

0 (réussite) ou 1 (échec)

Remarques

sp_dropsubscription est utilisé dans la réplication d’instantané et transactionnelle.

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.

Exemple

-- 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

Autorisations

Seuls les membres du rôle serveur fixe sysadmin , le rôle de base de données fixe db_owner ou l’utilisateur qui a créé l’abonnement peuvent exécuter sp_dropsubscription.

Voir aussi

Supprimer un abonnement par émission (push)
sp_addsubscription (Transact-SQL)
sp_changesubstatus (Transact-SQL)
sp_helpsubscription (Transact-SQL)