sys.dm_xe_objects (Transact-SQL)

  • Article

S’applique à : SQL ServerAzure SQL Database Azure SQL Managed Instance

Retourne une ligne pour chaque objet exposé par un package d'événement. Il peut s'agir de l'un des objets suivants :

  • Événements. Les événements indiquent les détails intéressants d'un chemin d'exécution. Tous les événements contiennent des informations sur un détail intéressant.

  • Actions. Les actions sont exécutées de façon synchrone lorsque les événements se déclenchent. Une action peut ajouter des données de temps d'exécution à un événement.

  • Cibles. Les cibles consomment des événements, de façon synchrone sur le thread qui déclenche l'événement ou de façon asynchrone sur un thread fourni par le système.

  • Prédicats. Les sources de prédicats récupèrent des valeurs à partir de sources d'événements pour les utiliser lors d'opérations de comparaison. Les comparaisons de prédicats comparent des types de données spécifiques et retournent une valeur booléenne.

  • Types. Les types encapsulent la longueur et les caractéristiques de la collection Byte, ce qui est nécessaire à l'interprétation des données.

Nom de la colonne Type de données Description
name nvarchar(60) Nom de l'objet. le nom est unique dans un package pour un type d’objet spécifique. N'accepte pas la valeur NULL.
object_type nvarchar(60) Type de l’objet. object_type est l’un des éléments suivants :

event

action

cible

pred_source

pred_compare

type

N'accepte pas la valeur NULL.
package_guid uniqueidentifier GUID pour le package qui expose cette action. Il y a une relation plusieurs-à-un avec sys.dm_xe_packages.package_id. N'accepte pas la valeur NULL.
description nvarchar (256) Description de l'action la description est définie par l’auteur du package. N'accepte pas la valeur NULL.
capabilities int Bitmap qui décrit les fonctionnalités de l'objet. Autorise la valeur NULL.
capabilities_desc nvarchar (256) Répertorie toutes les fonctionnalités de l'objet. Autorise la valeur NULL.

Fonctionnalités qui s’appliquent à tous les types d’objets

-
Privé. Le seul objet disponible pour une utilisation interne, qui n'est pas accessibles via CREATE/ALTER EVENT SESSION DDL. Les événements d'audit et les cibles sont classés dans cette catégorie, en plus d'un petit nombre d'objets utilisés en interne.

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

Fonctionnalités d’événement

-
No_block. L'événement est dans un chemin de code critique qui ne peut en aucun cas être bloqué. Les événements ayant cette fonction ne peuvent être ajoutés à aucune session d'événements qui spécifie NO_EVENT_LOSS.

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

Fonctionnalités qui s’appliquent à tous les types d’objets

-
Process_whole_buffers. La cible consomme des mémoires tampons d'événements à la fois, plutôt qu'un événement après l'autre.

-
Singleton. Une seule instance de la cible peut exister dans un processus. Bien que plusieurs sessions d'événements puissent référencer la même cible singleton, il existe réellement une seule instance, qui voit chaque événement une seule fois. C'est important si la cible est ajoutée à plusieurs sessions qui collectent toutes le même événement.

-
Synchronous. La cible est exécutée sur le thread qui produit l'événement, avant que le contrôle soit renvoyé à la ligne de code appelant.
TYPE_NAME nvarchar(60) Nom pour les objets pred_source et pred_compare. Autorise la valeur NULL.
type_package_guid uniqueidentifier GUID pour le package qui expose le type sur lequel fonctionne cet objet. Autorise la valeur NULL.
type_size int Taille du type de données, en octets. Uniquement pour les types d'objets valides. Autorise la valeur NULL.

autorisations

requièrent l'autorisation VIEW SERVER STATE sur le serveur.

Autorisations pour SQL Server 2022 (et versions plus récentes)

Nécessite l’autorisation VIEW SERVER PERFORMANCE STATE sur le serveur.

Cardinalités de la relation

Du À Relationship
sys.dm_xe_objects.package_guid sys.dm_xe_packages.guid Plusieurs-à-une

Étapes suivantes

En savoir plus sur les concepts associés dans les articles suivants :