sp_syscollector_delete_collection_set (Transact-SQL)

Artikel
07/07/2023

Löscht einen benutzerdefinierten Auflistsatz und all seine Sammlungselemente.

Syntax

sp_syscollector_delete_collection_set
    [ [ @collection_set_id = ] collection_set_id ]
    [ , [ @name = ] N'name' ]
[ ; ]

Argumente

[ @collection_set_id = ] collection_set_id

Der eindeutige Bezeichner für den Sammlungssatz. @collection_set_id ist int mit dem Standardwert NULL. @collection_set_id muss einen Wert aufweisen, wenn @name ist NULL.

[ @name = ] N'name'

Der Name des Sammlungssatzes. @name ist sysname mit dem Standardwert NULL. @name muss einen Wert aufweisen, wenn @collection_set_id ist NULL.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler).

Bemerkungen

sp_syscollector_delete_collection_set muss im Kontext der msdb Systemdatenbank ausgeführt werden.

Entweder @collection_set_id oder @name müssen einen Wert haben. Beide können nicht sein NULL. Um diese Werte zu erhalten, fragen Sie die syscollector_collection_set Systemansicht ab.

Systemdefinierte Sammlungssätze können nicht gelöscht werden.

Berechtigungen

Erfordert die Mitgliedschaft in der festen Datenbankrolle dc_admin (mit EXECUTE-Berechtigung), um dieses Verfahren ausführen zu können.

Beispiele

Im folgenden Beispiel wird ein benutzerdefinierter Sammlungssatz gelöscht, der die @collection_set_id angibt.

USE msdb;
GO
EXEC dbo.sp_syscollector_delete_collection_set
    @collection_set_id = 4;