Partilhar via

  • Artigo

fn_trace_gettable (Transact-SQL)

Retorna o conteúdo de um ou mais arquivos de rastreamento em formato tabular.

Ícone de vínculo de tópicoConvenções de sintaxe 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

O exemplo a seguir chama fn_trace_gettable dentro da cláusula FROM de uma instrução SELECT...INTO.

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

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

Conteúdo atualizado

Atualizada a seção Comentários com informações sobre o comportamento de arquivos de substituição quando o nome do arquivo de rastreamento original termina com um sublinhado e um valor numérico.