• Article

sys.server_event_sessions (Transact-SQL)

Répertorie toutes les définitions de session d'événements qui existent dans SQL Server.

Nom de colonne

Type de données

Description

event_session_id

int

ID unique de la session d'événements. N'accepte pas la valeur Null.

nom

sysname

Nom défini par l'utilisateur pour identifier la session d'événements. Il est unique. N'accepte pas la valeur Null.

event_retention_mode

nchar(1)

Détermine comment est gérée la perte d'événements. Il s'agit de l'une des valeurs suivantes :

  • S. Mappe avec event_retention_mode_desc = ALLOW_SINGLE_EVENT_LOSS

  • M. Mappe avec event_retention_mode_desc = ALLOW_MULTIPLE_EVENT_LOSS

  • N. Mappe avec event_retention_mode_desc = NO_EVENT_LOSS

La valeur par défaut est S. Elle n'accepte pas la valeur Null.

event_retention_mode_desc

sysname

Décrit comment est gérée la perte d'événements. Il s'agit de l'une des valeurs suivantes :

  • ALLOW_SINGLE_EVENT_LOSS. Il est possible de perdre des événements de la session. Les événements uniques ne sont abandonnés uniquement lorsque toutes les mémoires tampons d'événements sont saturées. La perte d'événements uniques lorsque les mémoires tampons d'événements sont saturées permet d'obtenir des caractéristiques de performance SQL Server acceptables, tout en réduisant la perte de données du flux d'événements traité.

  • ALLOW_MULTIPLE_EVENT_LOSS. Il est possible de perdre des mémoires tampons d'événements saturées de la session. Le nombre d'événements perdus dépend de la taille de la mémoire allouée à la session, du partitionnement de la mémoire et de la taille des événements dans la mémoire tampon. Cette option atténue l'impact sur les performances du serveur lorsque les mémoires tampons d'événements sont rapidement remplies. Toutefois, il est possible de perdre un grand nombre d'événements de la session.

  • NO_EVENT_LOSS. Aucune perte d'événements n'est autorisée. Cette option garantit que tous les événements déclenchés sont conservés. Elle force toutes les tâches qui déclenchent des événements à attendre que de l'espace se libère dans une mémoire tampon d'événements. Cette option peut entraîner des problèmes de performance détectables pendant que la session d'événements est active.

La valeur par défaut est ALLOW_SINGLE_EVENT_LOSS. N'accepte pas la valeur Null.

max_dispatch_latency

int

Durée (en secondes) pendant laquelle les événements sont mis en mémoire tampon avant d'être distribués aux cibles de la session. Les valeurs possibles vont de 1 à 2147483648 et -1. Une valeur de -1 indique que la latence de répartition est infinie. Accepte la valeur Null.

max_memory

int

Quantité de mémoire allouée à la session pour la mise en mémoire tampon d'événements. La valeur par défaut est 4 Mo. Accepte la valeur Null.

max_event_size

int

Quantité de mémoire réservée aux événements pour lesquels les mémoires tampons de session d'événements ne suffisent pas. Si max_event_size dépasse la taille de mémoire tampon calculée, deux mémoires tampons supplémentaires de max_event_size sont allouées à la session d'événements. Accepte la valeur Null.

memory_partition_mode

nchar(1)

Emplacement dans la mémoire où les mémoires tampons d'événements sont créées. memory_partition_mode peut être :

  • G - NONE

  • C - PER_CPU

  • N - PER_NODE

Le mode de partition par défaut est G. N'accepte pas la valeur Null.

memory_partition_mode_desc

sysname

Il s'agit de l'une des valeurs suivantes :

  • NONE. Un jeu unique de mémoires tampons est créé dans une instance SQL Server.

  • PER_CPU. Un jeu de mémoires tampons est créé pour chaque UC.

  • PER_NODE. Un jeu de mémoires tampons est créé pour chaque nœud NUMA (Non-Uniform Memory Access).

La valeur par défaut est NONE. N'accepte pas la valeur Null.

track_causality

bit

Activer ou désactiver le suivi de causalité. Si cette option a la valeur 1 (ON), le suivi est activé et les événements associés de différentes connexions au serveur peuvent être corrélés. Le paramètre par défaut est 0 (OFF). N'accepte pas la valeur Null.

startup_state

bit

Cette valeur détermine si la session est lancée automatiquement au démarrage du serveur. Les valeurs suivantes sont possibles :

  • 0 (OFF). La session ne se lance pas au démarrage du serveur.

  • 1 (ON). La session d'événements se lance au démarrage du serveur.

La valeur par défaut est 0. N'accepte pas la valeur Null.

Autorisations

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