sp_syscollector_delete_collection_item (Transact-SQL)
Se aplica a: SQL Server
Elimina un elemento de recopilación de un conjunto de recopilación
Convenciones de sintaxis de Transact-SQL
Sintaxis
sp_syscollector_delete_collection_item
[ [ @collection_item_id = ] collection_item_id ]
[ , [ @name = ] N'name' ]
[ ; ]
Argumentos
[ @collection_item_id = ] collection_item_id
Identificador único del elemento de colección. @collection_item_id es int, con un valor predeterminado de NULL
. @collection_item_id debe tener un valor si @name es NULL
.
[ @name = ] N'name'
Nombre del elemento de colección. @name es sysname, con un valor predeterminado de una cadena vacía. @name debe tener un valor si @collection_item_id es NULL
.
Valores de código de retorno
0
(correcto) o 1
(erróneo).
Comentarios
sp_syscollector_delete_collection_item
debe ejecutarse en el contexto de la base de datos del msdb
sistema. Los elementos de colección no se pueden eliminar de los conjuntos de recopilación del sistema.
El conjunto de recopilación que contiene el elemento de recopilación se detiene y reinicia durante esta operación.
Permisos
Requiere la pertenencia al rol fijo de base de datos dc_admin (con permiso EXECUTE) para ejecutar este procedimiento.
Ejemplos
En el ejemplo siguiente se elimina un elemento de recopilación denominado MyCollectionItem1
.
USE msdb;
GO
EXEC sp_syscollector_delete_collection_item @name = 'MyCollectionItem1';