sp_syscollector_delete_collection_item (Transact-SQL)
Elimina un elemento della raccolta da un insieme di raccolta
.gif "Icona di collegamento a un argomento")
Sintassi
sp_syscollector_delete_collection_item [[ @collection_item_id = ] collection_item_id ]
, [[ @name = ] 'name' ]
Argomenti
[ @collection\_item\_id = ] collection_item_id
Identificatore univoco per l'elemento della raccolta. collection_item_id è di tipo int e il valore predefinito è NULL. collection_item_id deve avere un valore se name è NULL.[ @name = ] 'name'
Nome dell'elemento della raccolta. name è di tipo sysname e il valore predefinito è NULL. name deve avere un valore se collection_item_id è NULL.
Valori dei codici restituiti
0 (esito positivo) o 1 (esito negativo)
Osservazioni
È necessario eseguire sp_syscollector_delete_collection_item nel contesto del database di sistema msdb. Non è possibile eliminare elementi della raccolta dagli insiemi di raccolta di sistema.
Durante questa operazione, l'insieme di raccolta che contiene l'elemento della raccolta viene interrotto e riavviato.
Autorizzazioni
Per eseguire questa procedura, è richiesta l'appartenenza al ruolo predefinito del database dc_admin (con autorizzazione EXECUTE).
Esempi
Nell'esempio seguente viene eliminato un elemento della raccolta denominato MyCollectionItem1.
USE msdb;
GO
EXEC sp_syscollector_delete_collection_item @name = 'MyCollectionItem1';