sys.fn_xe_file_target_read_file (Transact-SQL)

Se aplica a: síSQL Server (todas las versiones admitidas) SíAzure SQL Database

Lee los archivos creados en el destino de archivo asincrónico de Eventos extendidos. Se devuelve un evento, en formato XML, por cada fila.

Advertencia

SQL Server 2008 y SQL Server 2008 R2 aceptan los resultados de seguimiento generados en formato Xel y Xem. SQL Server 2012 (11.x) Los eventos extendidos solo admiten resultados de seguimiento en formato XEL. Es recomendable que use SQL Server Management Studio para leer los resultados de seguimiento en formato XEL.

Icono de vínculo de tema Convenciones de sintaxis de Transact-SQL

Sintaxis

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

Argumentos

path
Ruta de acceso a los archivos que se van a leer. la ruta de acceso puede contener caracteres comodín e incluir el nombre de un archivo. path es nvarchar (260). No existe ningún valor predeterminado. En el contexto de Azure SQL Database, este valor es una dirección URL HTTP a un archivo en Azure Storage.

mdpath
Ruta de acceso al archivo de metadatos correspondiente al archivo o archivos especificados por el argumento path . mdpath es nvarchar (260). No existe ningún valor predeterminado. A partir de SQL Server 2016, este parámetro se puede proporcionar como null.

Nota

SQL Server 2012 (11.x) no requiere el parámetro mdpath . Sin embargo, se mantiene para la compatibilidad con versiones anteriores para los archivos de registro generados en versiones anteriores de SQL Server.

initial_file_name
Primer archivo que se va a leer de path. initial_file_name es nvarchar (260). No existe ningún valor predeterminado. Si se especifica null como argumento, se leen todos los archivos encontrados en la ruta de acceso .

Nota

initial_file_name y initial_offset son argumentos emparejados. Si especifica un valor para cualquiera de ellos, debe especificar un valor para el otro.

initial_offset
Se usa para especificar el último desplazamiento leído previamente y omite todos los eventos hasta el desplazamiento (incluido). La enumeración de eventos comienza después del desplazamiento especificado. initial_offset es BIGINT. Si se especifica null como argumento, se leerá el archivo completo.

Tabla devuelta

Nombre de la columna Tipo de datos Descripción
module_guid uniqueidentifier GUID del módulo de eventos. No admite valores NULL.
package_guid uniqueidentifier GUID del paquete de eventos. No admite valores NULL.
object_name nvarchar(256) Nombre del evento. No admite valores NULL.
event_data nvarchar(max) Contenido del evento, en formato XML. No admite valores NULL.
file_name nvarchar(260) Nombre del archivo que contiene el evento. No admite valores NULL.
file_offset bigint Desplazamiento del bloque en el archivo que contiene el evento. No admite valores NULL.
timestamp_utc datetime2 Se aplica a: SQL Server 2017 (14.x) y versiones posteriores, y Azure SQL Database

Fecha y hora (zona horaria UTC) del evento. No admite valores NULL.

Observaciones

La lectura de grandes conjuntos de resultados ejecutando Sys.fn_xe_file_target_read_file en Management Studio puede producir un error. Use el modo resultados a archivo (Ctrl + Mayús + F) para exportar grandes conjuntos de resultados a un archivo y, en su lugar, leer el archivo con otra herramienta.

Permisos

es necesario contar con el permiso VIEW SERVER STATE en el servidor.

Ejemplos

A. Recuperar datos de los destinos de archivo

En el ejemplo siguiente se obtienen todas las filas de todos los archivos. En este ejemplo, los destinos de archivo y metarchivos se encuentran en la carpeta de seguimientos en la unidad C:.

SELECT * FROM sys.fn_xe_file_target_read_file('C:\traces\*.xel', 'C:\traces\metafile.xem', null, null);  

Consulte también

Vistas de administración dinámica de eventos extendidos
Vistas de catálogo de eventos extendidos (Transact-SQL)
Eventos extendidos