Compartir a través de

  • Artículo

fn_trace_gettable (Transact-SQL)

Devuelve el contenido de uno o varios archivos de seguimiento en forma de tabla.

Icono de vínculo a temasConvenciones 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. El argumento 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. El argumento number_files es de tipo int.

Notas

Si number_files se especifica como default, fn_trace_gettable lee todos los archivos de sustitución incremental hasta que llega 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 va a 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. Utilizar fn_trace_gettable para importar filas de un archivo de seguimiento

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

USE AdventureWorks;
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 AdventureWorks;
GO
SELECT IDENTITY(int, 1, 1) AS RowNumber, * INTO temp_trc
FROM fn_trace_gettable('c:\temp\mytrace.trc', default);
GO

Historial de cambios

Contenido actualizado

Se ha actualizado la sección Notas con información sobre el comportamiento de los archivos de sustitución incremental cuando el archivo de seguimiento original termina con un carácter de subrayado y un valor numérico.