• Article

sys.fn_xe_file_target_read_file (Transact-SQL)

Lit des fichiers créés par la cible de fichier asynchrone d'événements étendus. Au format XML, un événement par ligne est retourné.

Icône Lien de rubriqueConventions de syntaxe Transact-SQL

Syntaxe

sys.fn_xe_file_target_read_file ( path, mdpath, initial_file_name, initial_offset )

Arguments

  • path
    Chemin d'accès aux fichiers à lire. path peut contenir des caractères génériques et inclure le nom d'un fichier. path est de type nvarchar(260). Il n'y a pas de valeur par défaut.

  • mdpath
    Chemin d'accès au fichier de métadonnées qui correspond aux fichiers spécifiés par l'argument path. mdpath est de type nvarchar(260). Il n'y a pas de valeur par défaut.

  • initial_file_name
    Premier fichier de path à lire. initial_file_name est de type nvarchar(260). Il n'y a pas de valeur par défaut. Si null est spécifié comme argument, tous les fichiers trouvés dans path sont lus.

    [!REMARQUE]

    initial_file_name et initial_offset sont des arguments appariés. Si vous spécifiez une valeur pour l'un des arguments, vous devez en spécifier une pour l'autre.

  • initial_offset
    Offset du premier fichier où la lecture commence. initial_offset est de type bigint. Si null est spécifié comme argument, le fichier est lu dans son intégralité.

Table retournée

Nom de la colonne

Type de données

Description

module_guid

uniqueidentifier

GUID du module d'événements. Cette colonne n'accepte pas la valeur NULL.

package_guid

uniqueidentifier

GUID du package d'événement. Cette colonne n'accepte pas la valeur NULL.

object_name

nvarchar(256)

Nom de l'événement. Cette colonne n'accepte pas la valeur NULL.

event_data

nvarchar(max)

Contenu de l'événement, au format XML. Cette colonne n'accepte pas la valeur NULL.

file_name

nvarchar(260)

Nom du fichier qui contient l'événement. Cette colonne n'accepte pas la valeur NULL.

file_offset

bigint

Offset du bloc dans le fichier qui contient l'événement. Cette colonne n'accepte pas la valeur NULL.

Autorisations

Nécessite une autorisation VIEW SERVER STATE sur le serveur.

Exemples

A. Récupération des données de cibles de fichiers

L'exemple ci-dessous obtient toutes les lignes de tous les fichiers. Dans cet exemple, les cibles de fichiers et les métafichiers se trouvent dans le dossier de trace sur le lecteur C:\.

select * from sys.fn_xe_file_target_read_file('C:\traces\*.xel', 'C:\traces\metafile.xem', null, null)