Freigeben über


sp_syscollector_delete_collection_item (Transact-SQL)

Gilt für: SQL Server

Löscht ein Sammelelement aus einem Sammlungssatz.

Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

[ @collection_item_id = ] collection_item_id

Der eindeutige Bezeichner für das Sammlungselement. @collection_item_id ist int mit einem Standardwert von NULL. @collection_item_id muss einen Wert aufweisen, wenn @name istNULL.

[ @name = ] N'name'

Der Name des Auflistungselements. @name ist "sysname" mit einem Standardwert einer leeren Zeichenfolge. @name muss einen Wert aufweisen, wenn @collection_item_id istNULL.

Rückgabecodewerte

0 (erfolgreich) oder 1 Fehler.

Hinweise

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

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

Berechtigungen

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

Beispiele

Im folgenden Beispiel wird ein Sammelelement mit dem Namen MyCollectionItem1 gelöscht.

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