• Artículo

sys.fn_xe_file_target_read_file (Transact-SQL)

Lee los archivos que se crean en el destino de archivos asincrónico de Extended Events. Se devuelve un evento, en formato XML, por cada fila.

Icono de vínculo a temasConvenciones 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. path puede contener caracteres comodín e incluir el nombre de un archivo. path es de tipo nvarchar(260). No tiene ningún valor predeterminado.

  • mdpath
    Ruta de acceso al archivo de metadatos que corresponde al archivo o archivos especificados por el argumento path. mdpath es de tipo nvarchar(260). No tiene ningún valor predeterminado.

  • initial_file_name
    Primer archivo que se va a leer de path. initial_file_name es de tipo nvarchar(260). No tiene ningún valor predeterminado. Si se especifica null como argumento, se leen todos los archivos que se encuentren en path.

    Nota

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

  • initial_offset
    Desplazamiento en el primer archivo en el que comienza la lectura. initial_offset es de tipo bigint. Si se especifica null como argumento, se leerá el archivo completo.

Tabla devuelta

Nombre de 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 acepta valores NULL.

object_name

nvarchar(256)

Nombre del evento. No acepta valores NULL.

event_data

nvarchar(max)

Contenido del evento, en formato XML. No acepta valores NULL.

file_name

nvarchar(260)

Nombre del archivo que contiene el evento. No acepta valores NULL.

file_offset

bigint

Desplazamiento del bloque en el archivo que contiene el evento. No acepta valores NULL.

Permisos

Se requiere 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 trazas en la unidad C:\.

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