sys.fn_MSxe_read_event_stream (Transact-SQL)

s’applique à :SQL Server Azure SQL Database Azure SQL Managed Instance

sys.fn_MSxe_read_event_stream retourne des données binaires pour une utilisation interne par la classe .NET QueryableXEventData . L’interface utilisateur des événements étendus dans SQL Server Management Studio (SSMS) utilise cette classe pour lire les données de session d’événements.

Pour afficher les données d’événements lisibles par l’homme, utilisez l’une des options suivantes au lieu d’appeler sys.fn_MSxe_read_event_stream directement :

Interface utilisateur d’événements étendus dans SSMS.
sys.fn_xe_file_target_read_file fonction table.

Conventions de la syntaxe Transact-SQL

Syntaxe

sys.fn_MSxe_read_event_stream ( source , source_option )

Arguments

source

Source spécifique des données d’événement retournées par la fonction. La source est nvarchar(260) sans valeur par défaut.

La source est interprétée différemment selon la valeur de source_option :

source_option Interprétation de la source

0 La source est le nom d’une session d’événements démarrée.

1 La source est le chemin d’accès aux fichiers journaux de session d’événements à lire.

Lorsqu’elle est utilisée avec des fichiers dans le système de fichiers local, la source doit inclure le nom d’un fichier journal de session d’événements et peut contenir * en tant que caractère générique.

Lorsqu’elle est utilisée avec des objets blob dans un conteneur de stockage Azure, la source est une URL HTTP construite par la concaténation de deux parties :

1. Chemin d’accès à un conteneur de stockage Stockage Azure, suivi d’une barre oblique (/).
2. Préfixe commun pour les noms d’objets blob dans le conteneur à lire.

Par exemple, l’utilisation https://<storage-account-name>.blob.core.windows.net/container-name>/xe_session en tant que source récupère des données de tous les objets blob avec des noms commençant par xe_session, et quel que soit le reste du nom de l’objet blob, y compris l’extension. Les caractères génériques ne peuvent pas être spécifiés. Des informations d’identification autorisant l’accès au conteneur stockage Azure doivent exister.

source_option	Interprétation de la source
`0`	La source est le nom d’une session d’événements démarrée.
`1`	La source est le chemin d’accès aux fichiers journaux de session d’événements à lire. Lorsqu’elle est utilisée avec des fichiers dans le système de fichiers local, la source doit inclure le nom d’un fichier journal de session d’événements et peut contenir `` en tant que caractère générique. Lorsqu’elle est utilisée avec des objets blob dans un conteneur de stockage Azure, la source* est une URL HTTP construite par la concaténation de deux parties : 1. Chemin d’accès à un conteneur de stockage Stockage Azure, suivi d’une barre oblique (`/`). 2. Préfixe commun pour les noms d’objets blob dans le conteneur à lire. Par exemple, l’utilisation `https://<storage-account-name>.blob.core.windows.net/container-name>/xe_session` en tant que source récupère des données de tous les objets blob avec des noms commençant par `xe_session`, et quel que soit le reste du nom de l’objet blob, y compris l’extension. Les caractères génériques ne peuvent pas être spécifiés. Des informations d’identification autorisant l’accès au conteneur stockage Azure doivent exister.

source_option

Option qui détermine le type de la source de données d’événement. Les valeurs possibles sont les suivantes :

Valeur	Description
`0`	Retourne les données d’événement du event_stream cible d’une session d’événements démarrée. La fonction s’exécute indéfiniment, retournant de nouvelles données d’événement à mesure que la session le produit.
`1`	Retourne les données d’événement des fichiers journaux d’événements étendus spécifiés par la source.

Table retournée

Nom de la colonne	Type de données	Description
type	Int	Le type d'événement. Non nullable.
données	image	Données d’événement binaires. Autorise la valeur NULL.

Rétroaction

Cette page a-t-elle été utile ?

Last updated on 2025-09-10