sp_dropmergepublication (Transact-SQL)

  • Artikel

Gilt für:SQL Server

Löscht eine Mergeveröffentlichung und den zugehörigen Momentaufnahme-Agent. Vor dem Löschen einer Mergeveröffentlichung müssen alle Abonnements gelöscht werden. Die Artikel in der Veröffentlichung werden automatisch gelöscht. Diese gespeicherte Prozedur wird im Publisher in der Publikationsdatenbank ausgeführt.

Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

[ @publication = ] N'Publikation'

Der Name der zu löschenden Publikation. @publication ist "sysname" ohne Standard. Wenn allalle vorhandenen Zusammenführungspublikationen entfernt werden, sowie der ihnen zugeordnete Momentaufnahmen-Agent Auftrag. Wenn Sie einen bestimmten Wert für @publication angeben, werden nur diese Publikation und der zugeordnete Momentaufnahmen-Agent Auftrag gelöscht.

[ @ignore_distributor = ] ignore_distributor

Wird verwendet, um eine Veröffentlichung zu löschen, ohne beim Verteiler Cleanuptasks auszuführen. @ignore_distributor ist bit, mit einem Standardwert von 0. Dieser Parameter wird auch bei der Neuinstallation des Verteilers verwendet.

[ @reserved = ] reserviert

Für die zukünftige Verwendung reserviert. @reserved ist bit, mit einem Standardwert von 0.

[ @ignore_merge_metadata = ] ignore_merge_metadata

Nur für Informationszwecke identifiziert. Wird nicht unterstützt. Zukünftige Kompatibilität wird nicht sichergestellt.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler).

Hinweise

sp_dropmergepublication wird in der Seriendruckreplikation verwendet.

sp_dropmergepublication rekursiv alle Artikel fallen, die einer Publikation zugeordnet sind, und legt dann die Publikation selbst ab. Eine Publikation kann nicht entfernt werden, wenn es sich um ein oder mehrere Abonnements handelt. Informationen zum Entfernen von Abonnements finden Sie unter "Löschen eines Pushabonnements" und "Löschen eines Pull-Abonnements".

Durch das Ausführen sp_dropmergepublication zum Ablegen einer Publikation werden keine veröffentlichten Objekte aus der Publikationsdatenbank oder die entsprechenden Objekte aus der Abonnementdatenbank entfernt. Verwenden Sie DROP <object>, um diese Objekte bei Bedarf manuell zu entfernen.

Beispiele

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

Berechtigungen

Nur Mitglieder der festen Serverrolle sysadmin oder die db_owner feste Datenbankrolle können ausgeführt werden sp_dropmergepublication.

Zugehöriger Inhalt