fn_trace_gettable (Transact-SQL)

Restituisce il contenuto di uno o più file di traccia in formato tabulare.

Icona di collegamento a un argomentoConvenzioni della sintassi Transact-SQL

Sintassi

fn_trace_gettable ( 'filename' , number_files )

Argomenti

  • 'filename'
    Specifica il file di traccia iniziale da leggere. filename è di tipo nvarchar(256) e non prevede alcun valore predefinito.

  • number_files
    Specifica il numero di file di rollover da leggere. Questo numero include il file iniziale specificato in filename. number_files è di tipo int.

Osservazioni

Se number_files viene specificato come default, fn_trace_gettable legge tutti i file di rollover fino a raggiungere la fine della traccia. fn_trace_gettable restituisce una tabella con tutte le colonne valide per la traccia specificata. Per ulteriori informazioni, vedere sp_trace_setevent (Transact-SQL).

Tenere presente che la funzione fn_trace_gettable non caricherà file di rollover (quando questa opzione viene specificata tramite l'argomento number_files ) in cui il nome del file di traccia originale termina con un carattere di sottolineatura e un valore numerico. Ciò non vale per il carattere di sottolineatura e il numero che vengono aggiunti automaticamente all'esecuzione del rollover di un file. Come soluzione alternativa, è possibile rinominare i file di traccia in modo da rimuovere i caratteri di sottolineatura nel nome del file originale. Ad esempio, se il file originale è denominato Trace_Oct_5.trc e il file di rollover è denominato Trace_Oct_5_1.trc, è possibile rinominare i file in TraceOct5.trc e TraceOct5_1.trc.

Questa funzione consente di leggere una traccia ancora attiva nell'istanza in cui viene eseguita.

Autorizzazioni

È necessario disporre dell'autorizzazione ALTER TRACE nel server.

Esempi

A. Utilizzo di fn_trace_gettable per importare righe da un file di traccia

Nell'esempio seguente viene chiamato fn_trace_gettable all'interno della clausola FROM di un'istruzione SELECT...INTO.

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

B. Utilizzo di fn_trace_gettable per restituire una tabella con una colonna IDENTITY che può essere caricata in una tabella di SQL Server

Nell'esempio seguente questa funzione viene chiamata all'interno di un'istruzione SELECT...INTO e viene restituita una tabella con una colonna IDENTITY che può essere caricata nella tabella 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

Cronologia modifiche

Aggiornamento del contenuto

Aggiornata la sezione Osservazioni con le informazioni sul comportamento del file di rollover quando il nome del file di traccia originale termina con un carattere di sottolineatura e un valore numerico.