sp_syscollector_delete_collection_item (Transact-SQL)
Löscht ein Auflistelement aus einem Auflistsatz.
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 Auflistelement. 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 Auflistelements. 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. Auflistelemente können nicht aus Systemauflistsätzen gelöscht werden.
Der Auflistsatz mit dem Auflistelement 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 Auflistelement mit dem Namen MyCollectionItem1 gelöscht.
USE msdb;
GO
EXEC sp_syscollector_delete_collection_item @name = 'MyCollectionItem1';