Partager via


sp_syscollector_delete_collection_item (Transact-SQL)

S’applique à : SQL Server

Supprime un élément de collecte d’un jeu d’éléments de collecte.

Conventions de la syntaxe Transact-SQL

Syntaxe

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

Arguments

[ @collection_item_id = ] collection_item_id

Identificateur unique de l’élément de collection. @collection_item_id est int, avec la valeur par défaut NULL. @collection_item_id doit avoir une valeur si @name est NULL.

[ @name = ] N’name'

Nom de l’élément de collection. @name est sysname, avec une valeur par défaut d’une chaîne vide. @name doit avoir une valeur si @collection_item_id est NULL.

Valeurs des codes de retour

0 (réussite) ou 1 (échec).

Notes

sp_syscollector_delete_collection_item doit être exécuté dans le contexte de la msdb base de données système. Les éléments de collection ne peuvent pas être supprimés des jeux de regroupements système.

Le jeu d'éléments de collecte qui contient l'élément de collecte est arrêté puis redémarré au cours de cette opération.

autorisations

Nécessite l’appartenance au rôle de base de données fixe dc_admin (avec l’autorisation EXECUTE) pour exécuter cette procédure.

Exemples

L'exemple suivant supprime un élément de collecte appelé MyCollectionItem1.

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