Condividi tramite


sp_syscollector_delete_collection_item (Transact-SQL)

Si applica a: SQL Server

Elimina un elemento della raccolta da un set di raccolta

Convenzioni relative alla sintassi Transact-SQL

Sintassi

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

Argomenti

[ @collection_item_id = ] collection_item_id

Identificatore univoco per l'elemento della raccolta. @collection_item_id è int, con il valore predefinito NULL. @collection_item_id deve avere un valore se @name è NULL.

[ @name = ] N'name'

Nome dell'elemento della raccolta. @name è sysname, con un valore predefinito di una stringa vuota. @name deve avere un valore se @collection_item_id è NULL.

Valori del codice restituito

0 (esito positivo) o 1 (errore).

Osservazioni:

sp_syscollector_delete_collection_item deve essere eseguito nel contesto del msdb database di sistema. Gli elementi della raccolta non possono essere eliminati 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';