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