sp_syscollector_delete_collection_item (Transact-SQL)

Elimina un elemento della raccolta da un set di raccolta

Convenzioni 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 disporre di un valore se name è NULL.

• [ @name = ] 'name'
  Nome dell'elemento della raccolta. name è sysname e il valore predefinito è NULL. name deve disporre di un valore se collection_item_id è NULL.

Valori 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';

Vedere anche

Riferimento

sp_syscollector_create_collection_item (Transact-SQL)

Stored procedure dell'agente di raccolta dati (Transact-SQL)

syscollector_collection_items (Transact-SQL)

Concetti

Raccolta dati