Artikel
09/24/2010

sp_dropmergesubscription (Transact-SQL)

Löscht ein Abonnement für eine Mergeveröffentlichung und den zugehörigen Merge-Agent. Diese gespeicherte Prozedur wird beim Verleger mit der Veröffentlichungsdatenbank ausgeführt.

Themenlink (Symbol) Transact-SQL-Syntaxkonventionen

Syntax

sp_dropmergesubscription [ [ @publication= ] 'publication' ] 
    [ , [ @subscriber= ] 'subscriber'  
    [ , [ @subscriber_db= ] 'subscriber_db' ] 
    [ , [ @subscription_type= ] 'subscription_type' ] 
    [ , [ @ignore_distributor = ] ignore_distributor ] 
    [ , [ @reserved = ] reserved ]

Argumente

[ @publication=] 'publication'
Der Name der Veröffentlichung. publication ist vom Datentyp sysname und hat den Standardwert NULL. Die Veröffentlichung muss bereits vorhanden sein und den Regeln für Bezeichner entsprechen.
[ @subscriber = ] 'subscriber'
Der Name des Abonnenten. subscriber ist vom Datentyp sysname, der Standardwert ist NULL.
[ @subscriber_db = ] 'subscriber_db'
Der Name der Abonnementdatenbank. subscription_databaseist vom Datentyp sysname, der Standardwert ist NULL.

[ @subscription_type=] 'subscription_type'
Der Abonnementtyp. subscription_typeist vom Datentyp nvarchar(15). Die folgenden Werte sind möglich:

Wert	Beschreibung
all	Push-, Pull- und anonyme Abonnements.
anonymous	Anonymes Abonnement.
push	Pushabonnement.
pull	Pullabonnement.
both (Standard)	Sowohl Push- als auch Pullabonnements.

[ @ignore_distributor = ] ignore_distributor
Gibt an, ob diese gespeicherte Prozedur ausgeführt wird, ohne dass eine Verbindung mit dem Verteiler hergestellt wird. ignore_distributor ist vom Datentyp bit und hat den Standardwert 0. Mit diesem Parameter kann ein Abonnement gelöscht werden, ohne Cleanuptasks auf dem Verteiler auszuführen. Er erweist sich auch bei einer etwaigen Neuinstallation des Verteilers als hilfreich.
[ @reserved=] reserved
Ist für die zukünftige Verwendung reserviert. reserved ist vom Datentyp bit und hat den Standardwert 0.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Hinweise

sp_dropmergesubscription wird für die Mergereplikation verwendet.

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 merge publication.
DECLARE @publication AS sysname;
DECLARE @subscriber AS sysname;
DECLARE @subscriptionDB AS sysname;
SET @publication = N'AdvWorksSalesOrdersMerge';
SET @subscriber = $(SubServer);
SET @subscriptionDB = N'AdventureWorksReplica';

USE [AdventureWorks]
EXEC sp_dropmergesubscription 
  @publication = @publication, 
  @subscriber = @subscriber, 
  @subscriber_db = @subscriptionDB;
GO