sp_dropmergesubscription (Transact-SQL)

Artikel
05/07/2013

Löscht ein Abonnement für eine Mergeveröffentlichung und den zugehörigen Merge-Agent. Diese gespeicherte Prozedur wird auf dem Verleger für die 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 und hat den Standardwert NULL.
[ @subscriber_db= ] 'subscriber_db'
Der Name der Abonnementdatenbank. subscription_databaseist vom Datentyp sysname und hat den Standardwert NULL.

[ @subscription_type= ] 'subscription_type'
Der Typ des Abonnements. 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 eine Verbindung mit dem Verteiler herzustellen. ignore_distributor ist vom 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 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'AdventureWorks2012Replica';

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