Partager via


sp_syscollector_delete_collection_item (Transact-SQL)

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

Icône Lien de rubriqueConventions de la syntaxe Transact-SQL

Syntaxe

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

Arguments

  • [ @collection_item_id = ] collection_item_id
    Identificateur unique de l'élément de collecte. collection_item_id est de type int avec NULL comme valeur par défaut. collection_item_id doit avoir une valeur si la valeur de name est NULL.

  • [ @name = ] 'name'
    Nom de l'élément de collecte. name est de type sysname avec NULL comme valeur par défaut. name doit avoir une valeur si la valeur de collection_item_id est NULL.

Valeurs des codes de retour

0 (succès) ou 1 (échec)

Notes

sp_syscollector_delete_collection_item doit être exécuté dans le contexte de la base de données système msdb. Il est impossible de supprimer des éléments de collecte de jeux d'éléments de collecte système.

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

Autorisations

L'exécution de cette procédure requiert l'appartenance au rôle de base de données fixe dc_admin (avec l'autorisation EXECUTE).

Exemples

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

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