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é.
Attention |
---|
SQL Server 2008 et SQL Server 2008 R2 reçoivent les résultats de trace générés au format XEL et XEM. Les événements étendus SQL Server 2011 prennent en charge uniquement les résultats de trace au format XEL. Nous vous recommandons d'utiliser SQL Server Profiler pour lire les résultats de trace au format XEL. |
Conventions de la 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.[!REMARQUE]
SQL Server 2011 ne nécessite pas de paramètre mdpath. Toutefois, celui-ci est conservé pour la compatibilité descendante des fichiers journaux générés dans les versions antérieures de SQL Server.
initial_file_name
Premier fichier à lire à partir de path. 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. N'accepte pas la valeur NULL. |
package_guid |
uniqueidentifier |
GUID du package d'événement. N'accepte pas la valeur NULL. |
object_name |
nvarchar(256) |
Nom de l'événement. N'accepte pas la valeur NULL. |
event_data |
nvarchar(max) |
Contenu de l'événement, au format XML. N'accepte pas la valeur NULL. |
file_name |
nvarchar(260) |
Nom du fichier qui contient l'événement. 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)
Voir aussi
Référence
Vues de gestion dynamique des Événements étendus
Affichages catalogue des événements étendus (Transact-SQL)