fn_trace_gettable (Transact-SQL)

Sintaxe

fn_trace_gettable ( 'filename' , number_files )

Argumentos

• 'filename'
  Especifica o arquivo de rastreamento inicial a ser lido. filename é nvarchar(256), sem nenhum padrão.

• number_files
  Especifica o número de arquivos de substituição a serem lidos. Esse número inclui o arquivo inicial especificado em filename. number_files é um int.

Comentários

Se number_files for especificado como default, fn_trace_gettable lerá todos os arquivos de substituição até alcançar o fim do rastreamento. fn_trace_gettable retorna uma tabela com todas as colunas válidas para o rastreamento especificado. Para obter mais informações, consulte sp_trace_setevent (Transact-SQL).

Lembre-se de que a função fn_trace_gettable não carregará arquivos de substituição (quando esta opção for especificada com o argumento number_files) onde o nome de arquivo de rastreamento original terminar com um sublinhado e um valor numérico. (Isso não se aplica ao sublinhado e ao número que são acrescentados automaticamente quando um arquivo é substituído.) Como alternativa, você pode renomear os arquivos de rastreamento para remover os sublinhados no nome de arquivo original. Por exemplo, se o arquivo original tiver o nome Trace_Oct_5.trc e o arquivo de substituição tiver o nome Trace_Oct_5_1.trc, você poderá renomear os arquivos para TraceOct5.trc e TraceOct5_1.trc.

Essa função pode ler um rastreamento que ainda esteja ativo na instância em que é executado.

Permissões

Requer a permissão ALTER TRACE no servidor.

Exemplos

A. Usando fn_trace_gettable para importar linhas de um arquivo de rastreamento

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

B. Usando fn_trace_gettable para retornar uma tabela com uma coluna IDENTITY que pode ser carregada em uma tabela do SQL Server

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

Histórico de alterações

Consulte também

Referência