• Artikel

sp_syscollector_delete_collection_set (Transact-SQL)

Löscht einen benutzerdefinierten Auflistsatz und all seine Auflistelemente.

Themenlink (Symbol)Transact-SQL-Syntaxkonventionen

Syntax

sp_syscollector_delete_collection_set [[ @collection_set_id = ] collection_set_id OUTPUT ]
        , [[ @name = ] 'name' ]

Argumente

  • [ @collection_set_id = ] collection_set_id
    Der eindeutige Bezeichner für den Auflistsatz. collection_set_id ist vom Datentyp int und muss über einen Wert verfügen, wenn name NULL ist.

  • [ @name = ] 'name'
    Der Name des Auflistsatzes. name ist vom Datentyp sysname und muss über einen Wert verfügen, wenn collection_set_id NULL ist.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Hinweise

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

Entweder collection_set_id oder name muss über einen Wert verfügen; es können nicht beide NULL sein. Um diese Werte abzurufen, fragen Sie die syscollector_collection_set-Systemsicht ab.

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

Berechtigungen

Damit diese Prozedur ausgeführt werden kann, ist die Mitgliedschaft in der festen Datenbankrolle dc_admin (mit EXECUTE-Berechtigung) erforderlich.

Beispiele

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

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