Compartir a través de


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