sys.fn_trace_gettable (Transact-SQL)

Aplica-se a: SQL Server

Devolve o conteúdo de um ou mais ficheiros de traço em forma tabular.

Importante

Esse recurso será removido em uma versão futura do SQL Server. Evite usar esse recurso em novos trabalhos de desenvolvimento e planeje modificar aplicativos que atualmente usam esse recurso. Em vez disso, use Extended Events.

Transact-SQL convenções de sintaxe

Syntax

  
fn_trace_gettable ( 'filename' , number_files )

Arguments

'nome do ficheiro'
Especifica o ficheiro de traço inicial a ser lido. O nome do ficheiro é nvarchar(256), sem padrão.

number_files
Especifica o número de ficheiros de rollover a ler. Este número inclui o ficheiro inicial especificado no nome do ficheiro. number_files é uma int.

Remarks

Se number_files for especificado como padrão, fn_trace_gettable lê todos os ficheiros de rollover até chegar ao fim do rastreio. fn_trace_gettable devolve uma tabela com todas as colunas válidas para o traço especificado. Para mais informações, consulte sp_trace_setevent (Transact-SQL).

Tenha em atenção que a função fn_trace_gettable não carrega ficheiros de rollover (quando esta opção é especificada usando o argumento number_files ) onde o nome original do ficheiro de traço termina com um sublinhado e um valor numérico. (Isto não se aplica ao sublinhado e ao número que são automaticamente adicionados quando um ficheiro é rolado.) Como solução alternativa, podes renomear os ficheiros de rastreamento para remover os subpontos no nome original do ficheiro. Por exemplo, se o ficheiro original se chamar Trace_Oct_5.trc e o ficheiro de rollover se chamar Trace_Oct_5_1.trc, pode renomear os ficheiros para TraceOct5.trc e TraceOct5_1.trc.

Esta função pode ler um traço que ainda está ativo na instância em que é executado.

Permissions

Requer permissão ALTER TRACE no servidor.

Examples

A. Usar fn_trace_gettable para importar linhas de um ficheiro de rastreio

O exemplo seguinte chama fn_trace_gettable dentro da FROM cláusula de uma SELECT...INTO afirmação.

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

B. Usar fn_trace_gettable para devolver uma tabela com uma IDENTITY coluna que pode ser carregada numa tabela SQL Server

O exemplo seguinte chama a função como parte de uma SELECT...INTO instrução e devolve uma tabela com uma IDENTITY coluna que pode ser carregada na tabela 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

Ver também

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

  • Last updated on