• Artikel

sp_syscollector_delete_collection_item (Transact-SQL)

Löscht ein Sammelelement aus einem Sammlungssatz.

Themenlink (Symbol)Transact-SQL-Syntaxkonventionen

Syntax

sp_syscollector_delete_collection_item [[ @collection_item_id = ] collection_item_id ]
        , [[ @name = ] 'name' ]

Argumente

  • [ @collection_item_id = ] collection_item_id
    Der eindeutige Bezeichner für das Sammelelement. collection_item_id ist int mit dem Standardwert NULL. collection_item_id muss über einen Wert verfügen, wenn name gleich NULL ist.

  • [ @name = ] 'name'
    Der Name des Sammelelements. name ist sysname mit dem Standardwert NULL. name muss über einen Wert verfügen, wenn collection_item_id gleich NULL ist.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Hinweise

sp_syscollector_delete_collection_item muss im Kontext der msdb-Systemdatenbank ausgeführt werden. Sammelelemente können nicht aus Systemsammlungssätzen gelöscht werden.

Der Sammlungssatz mit dem Sammelelement wird während dieses Vorgangs beendet und neu gestartet.

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 Sammelelement mit dem Namen MyCollectionItem1 gelöscht.

USE msdb;
GO
EXEC sp_syscollector_delete_collection_item @name = 'MyCollectionItem1';