fn_trace_gettable (Transact-SQL)
Retorna o conteúdo de um ou mais arquivos de rastreamento em formato tabular.
.gif "Ícone de vínculo de tópico")
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 sobreposição até atingir o final 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 na qual é 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
O exemplo a seguir chama fn_trace_gettable dentro da cláusula FROM de uma instrução SELECT...INTO.
USE AdventureWorks2008R2;
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
O exemplo a seguir chama a função como parte de uma instrução SELECT...INTO e retorna uma tabela com uma coluna IDENTITY que pode ser carregada na tabela temp_trc.
USE AdventureWorks2008R2;
GO
SELECT IDENTITY(int, 1, 1) AS RowNumber, * INTO temp_trc
FROM fn_trace_gettable('c:\temp\mytrace.trc', default);
GO