sp_droppullsubscription (Transact-SQL)sp_droppullsubscription (Transact-SQL)

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

Supprime un abonnement à la base de données en cours de l'Abonné.Drops a subscription at the current database of the Subscriber. Cette procédure stockée est exécutée sur la base de données d'abonnement par extraction de données (pull) de l'abonné.This stored procedure is executed at the Subscriber on the pull subscription database.

Icône de lien de rubrique Conventions de la syntaxe Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SyntaxeSyntax

  
sp_droppullsubscription [ @publisher= ] 'publisher'  
        , [ @publisher_db= ] 'publisher_db'  
        , [ @publication= ] 'publication'  
    [ , [ @reserved= ] reserved ]  

ArgumentsArguments

[ @publisher = ] 'publisher'Nom du serveur distant.[ @publisher = ] 'publisher' Is the remote server name. Publisher est de type sysname, sans valeur par défaut.publisher is sysname, with no default. Si la totalitéest, l’abonnement est supprimé de tous les serveurs de publication.If all, the subscription is dropped at all the Publishers.

[ @publisher_db = ] 'publisher_db'Nom de la base de données du serveur de publication.[ @publisher_db = ] 'publisher_db' Is the name of the Publisher database. publisher_db est de type sysname, sans valeur par défaut.publisher_db is sysname, with no default. All signifie toutes les bases de données du serveur de publication.all means all the Publisher databases.

[ @publication = ] 'publication'Nom de la publication.[ @publication = ] 'publication' Is the publication name. publication est de type sysname, sans valeur par défaut.publication is sysname, with no default. Si la valeur est All, l’abonnement est déposé dans toutes les publications.If all, the subscription is dropped to all the publications.

[ @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.[ @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

la procédure pas à pas est utilisée dans la réplication d’instantané et la réplication transactionnelle.sp_droppullsubscription is used in snapshot replication and transactional replication.

la table de l’éditeur supprime la ligne correspondante dans la table Transact-SQL () MSreplication_subscriptions et l’agent de distribution correspondant sur l’abonné.sp_droppullsubscription deletes the corresponding row in the MSreplication_subscriptions (Transact-SQL) table and the corresponding Distributor Agent at the Subscriber. Si aucune ligne n’est laissée dans le champ MSreplication_subscriptions (Transact-SQL), elle supprime la table.If no rows are left in MSreplication_subscriptions (Transact-SQL), it drops the table.

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 is the batch executed at the Subscriber to drop 
-- a pull subscription to a transactional publication.
DECLARE @publication AS sysname;
DECLARE @publisher AS sysname;
DECLARE @publicationDB     AS sysname;
SET @publication = N'AdvWorksProductTran';
SET @publisher = $(PubServer);
SET @publicationDB = N'AdventureWorks2012';

USE [AdventureWorks2012Replica]
EXEC sp_droppullsubscription 
  @publisher = @publisher, 
  @publisher_db = @publicationDB, 
  @publication = @publication;
GO

AutorisationsPermissions

Seuls les membres du rôle serveur fixe sysadmin ou de l’utilisateur qui a créé l’abonnement parextraction peuvent exécuter la fonction la licence.Only members of the sysadmin fixed server role or the user who created the pull subscription can execute sp_droppullsubscription. Le rôle de base de données fixe db_owner ne peut exécuter la valeur de la base de au cas que si l’utilisateur qui a créé l’abonnement par extraction de données appartient à ce rôle.The db_owner fixed database role is only able to execute sp_droppullsubscription if the user who created the pull subscription belongs to this role.

Voir aussiSee Also

Supprimer un abonnement par extraction Delete a Pull Subscription
sp_addpullsubscription (Transact-SQL) sp_addpullsubscription (Transact-SQL)
sp_change_subscription_properties (Transact-SQL) sp_change_subscription_properties (Transact-SQL)
sp_helppullsubscription (Transact-SQL) sp_helppullsubscription (Transact-SQL)
sp_dropsubscription (Transact-SQL)sp_dropsubscription (Transact-SQL)