sp_dropsubscription (Transact-SQL)

  • Artikel

Löscht Abonnements für bestimmte Artikel, Publikationen oder Abonnementgruppen auf dem Verleger. Diese gespeicherte Prozedur wird beim Verleger mit der Publikationsdatenbank ausgeführt.

Themenlink (Symbol)Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

  • [ @publication=] 'publication'
    Der Name der zugeordneten Publikation. publication ist vom Datentyp sysname und hat den Standardwert NULL. Mit all werden alle Abonnements für alle Publikationen für den angegebenen Abonnenten gelöscht. publication ist ein erforderlicher Parameter.
  • [ @article=] 'article'
    Der Name des Artikels. article ist vom Datentyp sysname und hat den Standardwert NULL. Mit all werden die Abonnements aller Artikel für alle angegebenen Publikationen und Abonnenten gelöscht. Verwenden Sie all für Publikationen, die die sofortige Aktualisierung ermöglichen. article ist ein erforderlicher Parameter.
  • [ @subscriber= ] 'subscriber'
    Der Name des Abonnenten, dessen Abonnements gelöscht werden. subscriber ist ein Wert vom Datentyp sysname und weist keinen Standardwert auf. Mit all werden alle Abonnements für alle Abonnenten gelöscht.
  • [ @destination_db=] 'destination_db'
    Der Name der Zieldatenbank. destination_db ist vom Datentyp sysname und hat den Standardwert NULL. Bei einem Wert von NULL werden alle Abonnements dieses Abonnenten gelöscht.
  • [ @ignore_distributor =] ignore_distributor
    Nur zur internen Verwendung.
  • [ @reserved=] 'reserved'
    Nur zur internen Verwendung.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Hinweise

sp_dropsubscription wird bei der Snapshot- und Transaktionsreplikation verwendet.

Wenn Sie das Abonnement für den Artikel einer immediate-sync-Publikation löschen, können Sie das Abonnement nur wieder hinzufügen, wenn Sie die Abonnements für alle Artikel der Publikation löschen und sie alle in einem Schritt wieder hinzufügen.

Berechtigungen

Nur Mitglieder der festen Serverrolle sysadmin, der festen Datenbankrolle db_owner oder der Benutzer, der das Abonnement erstellt hat, können sp_dropsubscription ausführen.

Beispiel

-- 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 [AdventureWorks]
EXEC sp_dropsubscription 
  @publication = @publication, 
  @article = N'all',
  @subscriber = @subscriber;
GO

Siehe auch

Verweis

sp_addsubscription (Transact-SQL)
sp_changesubstatus (Transact-SQL)
sp_helpsubscription (Transact-SQL)

Andere Ressourcen

How to: Delete a Push Subscription (Replication Transact-SQL Programming)

Hilfe und Informationen

Informationsquellen für SQL Server 2005