fn_trace_gettable (Transact-SQL)
Restituisce il contenuto di uno o più file di traccia in formato tabulare.
.gif "Icona di collegamento a un argomento")
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 quando non raggiunge 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 una file di traccia
Nell'esempio seguente viene chiamato fn_trace_gettable all'interno della clausola FROM di un'istruzione SELECT...INTO.
USE AdventureWorks2008R2;
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 AdventureWorks2008R2;
GO
SELECT IDENTITY(int, 1, 1) AS RowNumber, * INTO temp_trc
FROM fn_trace_gettable('c:\temp\mytrace.trc', default);
GO