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) or 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';