sys.dm_xe_objects (Transact-SQL)

Se aplica a:SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

Devuelve una fila por cada objeto expuesto por un paquete de eventos. Los objetos pueden ser alguno de los siguientes:

  • Eventos. Los eventos indican los puntos de interés en una ruta de ejecución. Todos los eventos contienen información sobre un punto de interés.

  • Acciones. Las acciones se ejecutan sincrónicamente cuando se activan los eventos. Una acción puede anexar información del tiempo de ejecución a un evento.

  • Destinos. Los destinos utilizan eventos, sincrónicamente en el subproceso que activa el evento o de forma asincrónica en un subproceso proporcionado por el sistema.

  • Predicados. Los orígenes de predicado recuperan los valores de los orígenes de eventos para utilizarlos en operaciones de comparación. Las comparaciones de predicado comparan tipos de datos concretos y devuelven un valor booleano.

  • Tipos. Los tipos encapsulan la longitud y las características de la colección byte, necesaria para interpretar los datos.

Nombre de la columna Tipo de datos Descripción
name nvarchar(60) El nombre del objeto. name es único dentro de un paquete para un tipo de objeto específico. No admite valores NULL.
object_type nvarchar(60) Tipo del objeto. object_type es uno de los siguientes:

event

action

Destino

pred_source

pred_compare

type

No admite valores NULL.
package_guid uniqueidentifier GUID del paquete que expone esta acción. Hay una relación de varios a uno con sys.dm_xe_packages.package_id. No admite valores NULL.
description nvarchar(256) Descripción de la acción. description la establece el autor del paquete. No admite valores NULL.
capabilities int Mapa de bits que describe las capacidades del objeto. Acepta valores NULL.
capabilities_desc nvarchar(256) Enumera todas las capacidades del objeto. Acepta valores NULL.

Capacidades que se aplican a todos los tipos de objeto

-
Privado. El único objeto disponible para uso interno, y al que no se puede acceder mediante la DLL CREATE/ALTER EVENT SESSION. Los destinos y los eventos de auditoría pertenecen a esta categoría, así como un pequeño número de objetos usados internamente.

===============

Capacidades de eventos

-
No_block. El evento está en una ruta de acceso de código crítica que se no puede bloquear por ningún motivo. Los eventos con esta capacidad no se pueden agregar a ninguna sesión de evento que especifique NO_EVENT_LOSS.

===============

Capacidades que se aplican a todos los tipos de objeto

-
Process_whole_buffers. El destino consume búferes de eventos a la vez, en lugar de evento por evento.

-
Singleton. Solamente puede haber una instancia del destino en un proceso. Aunque varias sesiones de eventos pueden hacer referencia al mismo destino singleton, en realidad solo hay una instancia, y esa instancia verá cada evento distinto una sola vez. Esto es importante si se agrega el destino a varias sesiones que recopilan el mismo evento.

-
Synchronous. El destino se ejecuta en el subproceso que produce el evento, antes de que se devuelva el control a la línea de código de llamada.
type_name nvarchar(60) Nombre de los objetos pred_source y pred_compare. Acepta valores NULL.
type_package_guid uniqueidentifier GUID del paquete que expone el tipo en el que este objeto funciona. Acepta valores NULL.
type_size int Tamaño del tipo de datos, en bytes. Solo es válido para los tipos de objetos válidos. Acepta valores NULL.

Permisos

es necesario contar con el permiso VIEW SERVER STATE en el servidor.

Permisos para SQL Server 2022 y versiones posteriores

Requiere el permiso VIEW SERVER PERFORMANCE STATE en el servidor.

Cardinalidades de relación

De En Relación
sys.dm_xe_objects.package_guid sys.dm_xe_packages.guid Varios a uno

Pasos siguientes

Obtenga más información sobre los conceptos relacionados en los artículos siguientes: