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

Anwendungsbereich:Applies to: JaSQL ServerSQL Server (alle unterstützten Versionen) yesSQL ServerSQL Server (all supported versions) JaVerwaltete Azure SQL-InstanzAzure SQL Managed InstanceYesVerwaltete Azure SQL-InstanzAzure SQL Managed InstanceAnwendungsbereich:Applies to: JaSQL ServerSQL Server (alle unterstützten Versionen) yesSQL ServerSQL Server (all supported versions) JaVerwaltete Azure SQL-InstanzAzure SQL Managed InstanceYesVerwaltete Azure SQL-InstanzAzure SQL Managed Instance

Löscht ein Abonnement in der aktuellen Datenbank des Abonnenten.Drops a subscription at the current database of the Subscriber. Diese gespeicherte Prozedur wird auf dem Abonnenten für die Pullabonnementdatenbank ausgeführt.This stored procedure is executed at the Subscriber on the pull subscription database.

Symbol für Themenlink Transact-SQL-SyntaxkonventionenTopic link icon Transact-SQL Syntax Conventions

SyntaxSyntax

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

ArgumenteArguments

[ @publisher = ] 'publisher' Der Name des Remote Servers.[ @publisher = ] 'publisher' Is the remote server name. Publisher ist vom Datentyp vom Datentyp sysnameund hat keinen Standardwert.publisher is sysname, with no default. Wenn alle, wird das Abonnement auf allen Verlegern abgelegt.If all, the subscription is dropped at all the Publishers.

[ @publisher_db = ] 'publisher_db' Der Name der Verleger Datenbank.[ @publisher_db = ] 'publisher_db' Is the name of the Publisher database. publisher_db ist vom Datentyp vom Datentyp sysnameund hat keinen Standardwert.publisher_db is sysname, with no default. all bezeichnet alle Verleger Datenbanken.all means all the Publisher databases.

[ @publication = ] 'publication' Der Name der Veröffentlichung.[ @publication = ] 'publication' Is the publication name. Publication ist vom Datentyp vom Datentyp sysnameund hat keinen Standardwert.publication is sysname, with no default. Wenn dies der Wert ist, wird das Abonnement für alle Veröffentlichungen gelöscht.If all, the subscription is dropped to all the publications.

[ @reserved = ] reserved Nur für Informationszwecke identifiziert.Identified for informational purposes only. Wird nicht unterstützt.Not supported. Zukünftige Kompatibilität wird nicht sichergestellt.Future compatibility is not guaranteed.[ @reserved = ] reserved Nur für Informationszwecke identifiziert.Identified for informational purposes only. Wird nicht unterstützt.Not supported. Zukünftige Kompatibilität wird nicht sichergestellt.Future compatibility is not guaranteed.

RückgabecodewerteReturn Code Values

0 (Erfolg) oder 1 (Fehler)0 (success) or 1 (failure)

HinweiseRemarks

sp_droppullsubscription wird bei der Momentaufnahme-und Transaktions Replikation verwendet.sp_droppullsubscription is used in snapshot replication and transactional replication.

sp_droppullsubscription löscht die entsprechende Zeile in der MSreplication_subscriptions (Transact-SQL-) Tabelle und den entsprechenden Verteiler-Agent auf dem Abonnenten.sp_droppullsubscription deletes the corresponding row in the MSreplication_subscriptions (Transact-SQL) table and the corresponding Distributor Agent at the Subscriber. Wenn MSreplication_subscriptions (Transact-SQL-)keine Zeilen verbleiben, wird die Tabelle gelöscht.If no rows are left in MSreplication_subscriptions (Transact-SQL), it drops the table.

BeispielExample

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

BerechtigungenPermissions

Nur Mitglieder der festen Server Rolle sysadmin oder der Benutzer, der das Pullabonnement erstellt hat, können sp_droppullsubscriptionausführen.Only members of the sysadmin fixed server role or the user who created the pull subscription can execute sp_droppullsubscription. Die db_owner festgelegte Daten Bank Rolle kann nur sp_droppullsubscription ausgeführt werden, wenn der Benutzer, der das Pullabonnement erstellt hat, zu dieser Rolle gehört.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.

Weitere InformationenSee Also

Löschen eines Pullabonnements 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)