sys.fn_xe_file_target_read_file (Transact-SQL)

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. La característica Eventos extendidos de SQL Server 2012 solo admite resultados de seguimiento en formato XEL. Es recomendable que use SQL Server Management Studio para leer los resultados de seguimiento en formato XEL.

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. 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 los archivos especificados por el argumento path. mdpath es de tipo nvarchar(260). No tiene ningún valor predeterminado.

  [!NOTA]

  SQL Server 2012 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 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
  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 de tipo bigint. Si se especifica null como argumento, se leerá todo el archivo.

Tabla devuelta

Nombre de columna	Tipo de datos	Descripción
module_guid	uniqueidentifier	GUID del módulo de eventos. No acepta 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 seguimientos en la unidad C:\.

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

Vea también

Referencia

Vistas de administración dinámica de eventos extendidos

Vistas de catálogo de eventos extendidos (Transact-SQL)

Conceptos

Eventos extendidos