Share via

sp_dropmergepublication (Transact-SQL)

  • Artikel

Löscht eine Mergepublikation und den zugehörigen Snapshot-Agent. Vor dem Löschen einer Mergepublikation müssen alle Abonnements gelöscht werden. Die Artikel in der Publikation werden automatisch gelöscht. Diese gespeicherte Prozedur wird beim Verleger mit der Publikationsdatenbank ausgeführt.

Themenlink (Symbol)Transact-SQL-Syntaxkonventionen

Syntax

sp_dropmergepublication [ @publication= ] 'publication' 
    [ , [ @ignore_distributor = ] ignore_distributor ] 
    [ , [ @reserved = ] reserved ]
    [ , [ @ignore_merge_metadata = ] ignore_merge_metadata ]

Argumente

  • [ @publication=] 'publication'
    Der Name der zu löschenden Publikation. publication ist vom Datentyp sysname und hat keinen Standardwert. Wenn der Wert all ist, werden alle vorhandenen Mergepublikationen und die ihnen zugeordneten Snapshot-Agent-Aufträge entfernt. Wenn Sie einen bestimmten Wert für publication angeben, werden nur diese Publikation und der ihr zugeordnete Snapshot-Agent-Auftrag gelöscht.
  • [ @ignore_distributor =] ignore_distributor
    Wird verwendet, um eine Publikation zu löschen, ohne Cleanuptasks auf dem Verteiler auszuführen. ignore_distributor ist vom Datentyp bit und hat den Standardwert 0. Dieser Parameter wird auch bei der Neuinstallation des Verteilers verwendet.
  • [ @reserved=] reserved
    Ist für die zukünftige Verwendung reserviert. reserved ist vom Datentyp bit und hat den Standardwert 0.
  • [ @ignore_merge_metadata= ] ignore_merge_metadata
    Nur interne Verwendung.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Hinweise

sp_dropmergepublication wird für die Mergereplikation verwendet.

sp_dropmergepublication löscht rekursiv alle einer Publikation zugeordneten Artikel. Anschließend wird die Publikation selbst gelöscht. Solange für eine Publikation ein Abonnement vorhanden ist, kann sie nicht gelöscht werden. Informationen zum Entfernen von Abonnements finden Sie unter How to: Delete a Push Subscription (Replication Transact-SQL Programming) und How to: Delete a Pull Subscription (Replication Transact-SQL Programming).

Beim Ausführen von sp_dropmergepublication zum Löschen einer Publikation werden weder veröffentlichten Objekte in der Publikationsdatenbank noch die entsprechenden Objekte in der Abonnementdatenbank gelöscht. Verwenden Sie DROP <object>, um diese Objekte bei Bedarf manuell zu entfernen.

Berechtigungen

Nur Mitglieder der festen Serverrolle sysadmin oder der festen Datenbankrolle db_owner können sp_dropmergepublication ausführen.

Beispiel

DECLARE @publication AS sysname
DECLARE @publicationDB    AS sysname
SET @publication = N'AdvWorksSalesOrdersMerge' 
SET @publicationDB = N'AdventureWorks'

-- Remove the merge publication.
USE [AdventureWorks]
EXEC sp_dropmergepublication @publication = @publication;

-- Remove replication objects from the database.
USE master
EXEC sp_replicationdboption 
  @dbname = @publicationDB, 
  @optname = N'merge publish', 
  @value = N'false'
GO

Siehe auch

Verweis

sp_addmergepublication (Transact-SQL)
sp_changemergepublication (Transact-SQL)
sp_helpmergepublication (Transact-SQL)
Gespeicherte Replikationsprozeduren (Transact-SQL)

Andere Ressourcen

How to: Delete a Publication (Replication Transact-SQL Programming)

Hilfe und Informationen

Informationsquellen für SQL Server 2005