Compartir vía

sys.fn_trace_gettable (Transact-SQL)

  • Artículo

Se aplica a: SQL Server

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 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.

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 nvarchar(256), sin 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 nombre de archivo. number_files es un valor int.

Comentarios

Si number_files se especifica como predeterminado, fn_trace_gettable lee todos los archivos de sustitución por sustitución 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, consulte sp_trace_setevent (Transact-SQL).

Tenga en cuenta que la función fn_trace_gettable no cargará archivos de sustitución por sustitución (cuando se especifica esta opción mediante el argumento number_files ) donde 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 el número que se anexan automáticamente cuando se reemplaza un archivo). Como solución alternativa, puede cambiar el nombre de los archivos de seguimiento para quitar los caracteres de subrayado en el nombre de archivo original. Por ejemplo, si el archivo original se denomina Trace_Oct_5.trc y el archivo de sustitución por sustitución se denomina Trace_Oct_5_1.trc, puede cambiar el nombre de los archivos a TraceOct5.trc y TraceOct5_1.trc.

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

Consulte también

sp_trace_generateevent (Transact-SQL)
sp_trace_setevent (Transact-SQL)
sp_trace_setfilter (Transact-SQL)
sp_trace_setstatus (Transact-SQL)