sp_dropmergesubscription (Transact-SQL)

  • Artikel

Löscht ein Abonnement für eine Mergepublikation und den zugehörigen Merge-Agent. Diese gespeicherte Prozedur wird beim Verleger mit der Publikationsdatenbank 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 Publikation. publication ist vom Datentyp sysname und hat den Standardwert NULL. Die Publikation 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.

Berechtigungen

Nur Mitglieder der festen Serverrolle sysadmin oder der festen Datenbankrolle db_owner können sp_dropmergesubscription 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 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

Siehe auch

Verweis

sp_addmergesubscription (Transact-SQL)
sp_changemergesubscription (Transact-SQL)
sp_helpmergesubscription (Transact-SQL)

Andere Ressourcen

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

Hilfe und Informationen

Informationsquellen für SQL Server 2005