sys.fn_trace_gettable (Transact-SQL)

Devuelve el contenido de uno o más archivos de seguimiento en forma de tabla.

Importante

Esta característica se quitará en una versión futura de Microsoft SQL Server. Evite utilizar esta característica en nuevos trabajos de desarrollo y tenga previsto modificar las aplicaciones que actualmente la utilizan. Use eventos extendidos en su lugar.

Se aplica a: SQL Server (SQL Server 2008 a través de la versión actual).

Convenciones de sintaxis de Transact-SQL

Sintaxis

fn_trace_gettable ( 'filename' , number_files )

Argumentos

• 'filename'
  Especifica el archivo de seguimiento inicial que se va a leer. filename es de tipo nvarchar(256) y no tiene ningún valor predeterminado.

• number_files
  Especifica el número de archivos de sustitución que se van a leer. Este número incluye el archivo inicial especificado en filename. number_files es de tipo int.

Comentarios

Si number_files se especifica como default, fn_trace_gettable lee todos los archivos de sustitución incremental hasta llegar al final del seguimiento. fn_trace_gettable devuelve una tabla con todas las columnas válidas para el seguimiento especificado. Para obtener más información, vea sp_trace_setevent (Transact-SQL).

Tenga en cuenta que la función fn_trace_gettable no cargará los archivos de sustitución incremental (cuando esta opción esté especificada a través del argumento number_files) si el nombre del archivo de seguimiento original termina con un carácter de subrayado y un valor numérico. (Esto no se aplica al carácter de subrayado y al número que se anexan automáticamente cuando un archivo realiza la sustitución incremental). Para solucionar este problema, puede cambiar el nombre de los archivos de seguimiento y quitar los caracteres de subrayado del nombre de archivo original. Por ejemplo, si el nombre del archivo original es Trace_Oct_5.trc y el nombre del archivo de sustitución incremental es Trace_Oct_5_1.trc, puede cambiar el nombre de los archivos a TraceOct5.trc y TraceOct5_1.trc, respectivamente.

Esta función puede leer un seguimiento que todavía esté activo en la instancia en la que se ejecuta.

Permisos

Requiere el permiso ALTER TRACE en el servidor.

Ejemplos

A.Usar fn_trace_gettable para importar filas de un archivo de seguimiento

En el siguiente ejemplo se llama a fn_trace_gettable en la cláusula FROM de una instrucción SELECT...INTO.

USE AdventureWorks2012;
GO
SELECT * INTO temp_trc
FROM fn_trace_gettable('c:\temp\mytrace.trc', default);
GO

B.Usar fn_trace_gettable para devolver una tabla con una columna IDENTITY que se pueda cargar en una tabla de SQL Server

Este ejemplo llama a la función como parte de una instrucción SELECT...INTO y devuelve una tabla con una columna IDENTITY que se puede cargar en la tabla temp_trc.

USE AdventureWorks2012;
GO
SELECT IDENTITY(int, 1, 1) AS RowNumber, * INTO temp_trc
FROM fn_trace_gettable('c:\temp\mytrace.trc', default);
GO

Vea también

Referencia

sp_trace_generateevent (Transact-SQL)

sp_trace_setevent (Transact-SQL)

sp_trace_setfilter (Transact-SQL)

sp_trace_setstatus (Transact-SQL)