sp_syscollector_delete_collection_item (Transact-SQL)

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 = ] 'name' ] 

Argumentos

• [ @collection\_item\_id = ] collection_item_id
  Es el identificador único del elemento de recopilación. collection_item_id es de tipo int y su valor predeterminado es NULL. collection_item_id debe tener un valor si name es NULL.

• [ @name = ] 'name'
  Es el nombre del elemento de colección. name es de tipo sysname y su valor predeterminado es NULL. name debe tener un valor si collection_item_id es NULL.

Valores de código de retorno

0 (correcto) o 1 (error)

Comentarios

Se debe ejecutar sp_syscollector_delete_collection_item en el contexto de la base de datos del sistema msdb. Los elementos de recopilació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';

Vea también

Referencia

sp_syscollector_create_collection_item (Transact-SQL)

Procedimientos almacenados del recopilador de datos (Transact-SQL)

syscollector_collection_items (Transact-SQL)

Conceptos

Recopilación de datos