Teilen über


sp_syscollector_delete_collection_set (Transact-SQL)

Gilt für: SQL Server

Löscht einen benutzerdefinierten Auflistsatz und all seine Sammlungselemente.

Transact-SQL-Syntaxkonventionen

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 einem Standardwert von NULL. @collection_set_id muss einen Wert aufweisen, wenn @name istNULL.

[ @name = ] N'name'

Der Name des Sammlungssatzes. @name ist "sysname" mit einem Standardwert von NULL. @name muss einen Wert aufweisen, wenn @collection_set_id istNULL.

Rückgabecodewerte

0 (erfolgreich) oder 1 Fehler.

Hinweise

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

Entweder @collection_set_id oder @name müssen einen Wert aufweisen, beide können nicht sein NULL. Um diese Werte abzurufen, fragen Sie die syscollector_collection_set Systemansicht ab.

Vom System definierte Sammlungssätze können nicht gelöscht werden.

Berechtigungen

Erfordert die Mitgliedschaft in der festen Datenbankrolle dc_admin (mit EXECUTE-Berechtigung), um dieses Verfahren auszuführen.

Beispiele

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

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