Compartir a través de

  • Artículo

sp_syscollector_delete_collection_item (Transact-SQL)

Elimina un elemento de recopilación de un conjunto de recopilaciones

Icono de vínculo a temasConvenciones 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 para el elemento de recopilación. collection_item_id es 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 recopilación. name es 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)

Notas

sp_syscollector_delete_collection_item se debe ejecutar dentro del 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

Debe pertenecer a la función de base de datos fija dc_admin (con permiso EXECUTE) para ejecutar este procedimiento.

Ejemplos

En el ejemplo siguiente se elimina un elemento de la colección denominado MyCollectionItem1.

USE msdb;
GO
EXEC sp_syscollector_delete_collection_item @name = 'MyCollectionItem1';