sp_dropmergepublication (Transact-SQL)
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.
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)