Condividi tramite


sp_syscollector_delete_collection_item (Transact-SQL)

Elimina un elemento della raccolta da un set di raccolta

Icona di collegamento a un argomentoConvenzioni della sintassi Transact-SQL

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.

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 dai set di raccolta di sistema.

Durante questa operazione, il set di raccolta che contiene l'elemento della raccolta viene arrestato 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';