sp_dropsubscription (Transact-SQL)

  • Artikel

Gilt für:SQL ServerAzure SQL Managed Instance

Löscht Abonnements für bestimmte Artikel, Veröffentlichungen oder Abonnementgruppen auf dem Verleger. Diese gespeicherte Prozedur wird im Publisher in der Publikationsdatenbank ausgeführt.

Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

[ @publication = ] N'Publikation'

Der Name der zugehörigen Publikation. @publication ist "sysname" mit der Standardeinstellung "NULL. Wenn allalle Abonnements für alle Publikationen für den angegebenen Abonnenten storniert werden. Publikation ist ein erforderlicher Parameter.

[ @article = ] N'article'

Der Name des Artikels. @article ist "sysname" mit der Standardeinstellung "NULL. Wenn all, Abonnements für alle Artikel für jede angegebene Publikation und Abonnenten gelöscht werden. Wird für Publikationen verwendet all , die eine sofortige Aktualisierung ermöglichen.

[ @subscriber = ] N'subscriber'

Der Name des Abonnenten, der seine Abonnements verworfen hat. @subscriber ist "sysname" ohne Standard. Wenn allalle Abonnements für alle Abonnenten verworfen werden.

[ @destination_db = ] N'destination_db'

Der Name der Zieldatenbank. @destination_db ist "sysname" mit der Standardeinstellung "NULL. Wenn NULLalle Abonnements dieses Abonnenten gelöscht werden.

[ @ignore_distributor = ] ignore_distributor

Nur für Informationszwecke identifiziert. Wird nicht unterstützt. Zukünftige Kompatibilität wird nicht sichergestellt.

[ @reserved = ] N'reserved'

Nur für Informationszwecke identifiziert. Wird nicht unterstützt. Zukünftige Kompatibilität wird nicht sichergestellt.

[ @publisher = ] N'publisher'

Nur für Informationszwecke identifiziert. Wird nicht unterstützt. Zukünftige Kompatibilität wird nicht sichergestellt.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler).

Hinweise

sp_dropsubscriptionwird in Momentaufnahme- und Transaktionsreplikation verwendet.

Wenn Sie das Abonnement für einen Artikel in einer sofortigen Synchronisierungsveröffentlichung ablegen, können Sie es nur dann wieder hinzufügen, wenn Sie die Abonnements für alle Artikel in der Publikation ablegen und alle wieder auf einmal hinzufügen.

Beispiele

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

Berechtigungen

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

Zugehöriger Inhalt