sp_dropmergesubscription (Transact-SQL)sp_dropmergesubscription (Transact-SQL)

Anwendungsbereich:Applies to: JaSQL ServerSQL Server (alle unterstützten Versionen) yesSQL ServerSQL Server (all supported versions) Anwendungsbereich:Applies to: JaSQL ServerSQL Server (alle unterstützten Versionen) yesSQL ServerSQL Server (all supported versions)

Löscht ein Abonnement für eine Mergeveröffentlichung und den zugehörigen Merge-Agent.Drops a subscription to a merge publication and its associated Merge Agent. Diese gespeicherte Prozedur wird auf dem Verleger für die Veröffentlichungs Datenbank ausgeführt.This stored procedure is executed at the Publisher on the publication database.

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

SyntaxSyntax

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

ArgumenteArguments

[ @publication = ] 'publication' Der Name der Veröffentlichung.[ @publication = ] 'publication' Is the publication name. Publication ist vom Datentyp vom Datentyp sysnameund hat den Standardwert NULL.publication is sysname, with a default of NULL. Die Veröffentlichung muss bereits vorhanden sein und den Regeln für Bezeichner entsprechen.The publication must already exist and conform to the rules for identifiers.

[ @subscriber = ] 'subscriber' Der Name des Abonnenten.[ @subscriber = ] 'subscriber' Is the name of the Subscriber. Subscriber ist vom Datentyp vom Datentyp sysnameund hat den Standardwert NULL.subscriber is sysname, with a default of NULL.

[ @subscriber_db = ] 'subscriber_db' Der Name der Abonnement Datenbank.[ @subscriber_db = ] 'subscriber_db' Is the name of the subscription database. subscription_databaseist vom Datentyp vom Datentyp sysnameund hat den Standardwert NULL.subscription_databaseis sysname, with a default of NULL.

[ @subscription_type = ] 'subscription_type' Der Abonnementtyp.[ @subscription_type = ] 'subscription_type' Is the type of subscription. subscription_typeist vom Datentyp nvarchar (15). die folgenden Werte sind möglich:subscription_typeis nvarchar(15), and can be one of these values.

WertValue BESCHREIBUNGDescription
allenall Push-, Pull- und anonyme Abonnements.Push, pull, and anonymous subscriptions
Anonymousanonymous Anonymes Abonnement.Anonymous subscription.
pushpush Pushabonnement.Push subscription.
auszupull Pullabonnement.Pull subscription.
both (Standard)both (default) Sowohl Push- als auch Pullabonnements.Both push and pull subscriptions.

[ @ignore_distributor = ] ignore_distributor Gibt an, ob diese gespeicherte Prozedur ausgeführt wird, ohne eine Verbindung mit dem Verteiler herzustellen.[ @ignore_distributor = ] ignore_distributor Indicates whether this stored procedure is executed without connecting to the Distributor. ignore_distributor ist vom Typ Bit. der Standardwert ist 0.ignore_distributor is bit, with a default of 0. Mit diesem Parameter kann ein Abonnement gelöscht werden, ohne Cleanuptasks auf dem Verteiler auszuführen.This parameter can be used to drop a subscription without doing cleanup tasks at the Distributor. Er erweist sich auch bei einer etwaigen Neuinstallation des Verteilers als hilfreich.It is also useful if you had to reinstall the Distributor.

[ @reserved = ] reserved Ist für die zukünftige Verwendung reserviert.[ @reserved = ] reserved Is reserved for future use. reserved ist vom Typ Bit. der Standardwert ist 0.reserved is bit, with a default of 0.

RückgabecodewerteReturn Code Values

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

HinweiseRemarks

sp_dropmergesubscription wird bei der Mergereplikation verwendet.sp_dropmergesubscription is used in merge replication.

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

BerechtigungenPermissions

Nur Mitglieder der festen Server Rolle sysadmin oder der festen Daten Bank Rolle db_owner können sp_dropmergesubscriptionausführen.Only members of the sysadmin fixed server role or the db_owner fixed database role can execute sp_dropmergesubscription.

Weitere InformationenSee Also

Löschen eines Pushabonnements Delete a Push Subscription
Löschen eines Pullabonnements Delete a Pull Subscription
sp_addmergesubscription (Transact-SQL-) sp_addmergesubscription (Transact-SQL)
sp_changemergesubscription (Transact-SQL-) sp_changemergesubscription (Transact-SQL)
sp_helpmergesubscription (Transact-SQL-)sp_helpmergesubscription (Transact-SQL)