sys.fn_xe_file_target_read_file (Transact-SQL)sys.fn_xe_file_target_read_file (Transact-SQL)
S’applique à :Applies to: 
SQL ServerSQL Server (toutes les versions prises en charge) SQL ServerSQL Server (all supported versions) Azure SQL DatabaseAzure SQL DatabaseAzure SQL DatabaseAzure SQL DatabaseSQL ServerSQL Server (toutes les versions prises en charge) SQL ServerSQL Server (all supported versions) Azure SQL DatabaseAzure SQL DatabaseAzure SQL DatabaseAzure SQL Database
Lit des fichiers créés par la cible de fichier asynchrone d'événements étendus.Reads files that are created by the Extended Events asynchronous file target. Au format XML, un événement par ligne est retourné.One event, in XML format, is returned per row.
Avertissement
SQL Server 2008SQL Server 2008 et SQL Server 2008 R2SQL Server 2008 R2 acceptent les résultats de trace générés au format Xel et Xem.and SQL Server 2008 R2SQL Server 2008 R2 accept trace results generated in XEL and XEM format. SQL Server 2012 (11.x)SQL Server 2012 (11.x) Les événements étendus prennent uniquement en charge les résultats de trace au format XEL.Extended Events only support trace results in XEL format. Nous vous recommandons d'utiliser SQL Server Management Studio pour lire les résultats de trace au format XEL.We recommend that you use SQL Server Management Studio to read trace results in XEL format.
Conventions de la syntaxe Transact-SQL Transact-SQL Syntax Conventions
SyntaxeSyntax
sys.fn_xe_file_target_read_file ( path, mdpath, initial_file_name, initial_offset )
ArgumentsArguments
pathpath
Chemin d'accès aux fichiers à lire.The path to the files to read. le chemin d’accès peut contenir des caractères génériques et inclure le nom d’un fichier.path can contain wildcards and include the name of a file. path est de type nvarchar (260).path is nvarchar(260). Il n'y a pas de valeur par défaut.There is no default. Dans le contexte de Azure SQL Database, cette valeur est une URL HTTP vers un fichier dans le stockage Azure.In the context of Azure SQL Database, this value is an HTTP URL to a file in Azure Storage.
mdpathmdpath
Chemin d’accès au fichier de métadonnées qui correspond aux fichiers spécifiés par l’argument path .The path to the metadata file that corresponds to the file or files specified by the path argument. mdpath est de type nvarchar (260).mdpath is nvarchar(260). Il n'y a pas de valeur par défaut.There is no default. À compter de SQL Server 2016, ce paramètre peut être spécifié comme null.Starting with SQL Server 2016, this parameter can be given as null.
Notes
SQL Server 2012 (11.x)SQL Server 2012 (11.x) ne nécessite pas le paramètre mdpath .does not require the mdpath parameter. Toutefois, celui-ci est conservé pour la compatibilité descendante des fichiers journaux générés dans les versions antérieures de SQL Server.However, it is maintained for backward compatibility for log files generated in previous versions of SQL Server.
initial_file_nameinitial_file_name
Premier fichier à lire à partir du chemin d’accès.The first file to read from path. initial_file_name est de type nvarchar (260).initial_file_name is nvarchar(260). Il n'y a pas de valeur par défaut.There is no default. Si null est spécifié en tant qu’argument, tous les fichiers trouvés dans le chemin d’accès sont lus.If null is specified as the argument all the files found in path are read.
Notes
initial_file_name et initial_offset sont des arguments associés.initial_file_name and initial_offset are paired arguments. Si vous spécifiez une valeur pour l'un des arguments, vous devez en spécifier une pour l'autre.If you specify a value for either argument you must specify a value for the other argument.
initial_offsetinitial_offset
Utilisé pour spécifier le dernier décalage lu et ignorer tous les événements jusqu'au décalage (inclus).Used to specify last offset read previously and skips all events up to the offset (inclusive). Commence l'énumération d'événements après le décalage spécifié.Event enumeration starts after the offset specified. initial_offset est de type bigint.initial_offset is bigint. Si null est spécifié en tant qu’argument, la totalité du fichier est lue.If null is specified as the argument the entire file will be read.
Table retournéeTable Returned
| Nom de la colonneColumn name | Type de donnéesData type | DescriptionDescription |
|---|---|---|
| module_guidmodule_guid | uniqueidentifieruniqueidentifier | GUID du module d'événements.The event module GUID. N'accepte pas la valeur NULL.Is not nullable. |
| package_guidpackage_guid | uniqueidentifieruniqueidentifier | GUID du package d'événement.The event package GUID. N'accepte pas la valeur NULL.Is not nullable. |
| object_nameobject_name | nvarchar (256)nvarchar(256) | Nom de l’événement.The name of the event. N'accepte pas la valeur NULL.Is not nullable. |
| event_dataevent_data | nvarchar(max)nvarchar(max) | Contenu de l'événement, au format XML.The event contents, in XML format. N'accepte pas la valeur NULL.Is not nullable. |
| file_namefile_name | nvarchar(260)nvarchar(260) | Nom du fichier qui contient l'événement.The name of the file that contains the event. N'accepte pas la valeur NULL.Is not nullable. |
| file_offsetfile_offset | bigintbigint | Offset du bloc dans le fichier qui contient l'événement.The offset of the block in the file that contains the event. N'accepte pas la valeur NULL.Is not nullable. |
| timestamp_utctimestamp_utc | datetime2datetime2 | S’applique à : SQL Server 2017 (14.x)SQL Server 2017 (14.x) et versions ultérieures et Azure SQL DatabaseAzure SQL Database.Applies to: SQL Server 2017 (14.x)SQL Server 2017 (14.x) and later and Azure SQL DatabaseAzure SQL Database. Date et heure (fuseau horaire UTC) de l’événement.The date and time (UTC timezone) of the event. N'accepte pas la valeur NULL.Is not nullable. |
NotesRemarks
La lecture de jeux de résultats volumineux en exécutant sys.fn_xe_file_target_read_file dans Management StudioManagement Studio peut entraîner une erreur.Reading large result sets by executing sys.fn_xe_file_target_read_file in Management StudioManagement Studio may result in an error. Utilisez les résultats en mode fichier (Ctrl + Maj + F) pour exporter de grands jeux de résultats dans un fichier et lisez le fichier avec un autre outil à la place.Use the Results to File mode (Ctrl+Shift+F) to export large result sets to a file and read the file with another tool instead.
AutorisationsPermissions
requièrent l'autorisation VIEW SERVER STATE sur le serveur.Requires VIEW SERVER STATE permission on the server.
ExemplesExamples
R.A. Récupération des données de cibles de fichiersRetrieving data from file targets
L'exemple ci-dessous obtient toutes les lignes de tous les fichiers.The following example gets all the rows from all the files. Dans cet exemple, les cibles de fichiers et les métafichiers se trouvent dans le dossier de trace sur le lecteur C:.In this example the file targets and metafiles are located in the trace folder on the C:\ drive.
SELECT * FROM sys.fn_xe_file_target_read_file('C:\traces\*.xel', 'C:\traces\metafile.xem', null, null);
Voir aussiSee Also
Vues de gestion dynamique des événements étendus Extended Events Dynamic Management Views
Affichages catalogue des événements étendus (Transact-SQL) Extended Events Catalog Views (Transact-SQL)
Événements étendusExtended Events