sys.fn_trace_gettable (Transact-SQL)

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

Importante
Questa funzionalità verrà rimossa a partire da una delle prossime versioni di Microsoft SQL Server. Evitare di utilizzare questa funzionalità in un nuovo progetto di sviluppo e prevedere interventi di modifica nelle applicazioni in cui è attualmente implementata. In alternativa, utilizzare Eventi estesi.

Convenzioni 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 quando non viene raggiunta 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 AdventureWorks2012;
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 AdventureWorks2012;
GO
SELECT IDENTITY(int, 1, 1) AS RowNumber, * INTO temp_trc
FROM fn_trace_gettable('c:\temp\mytrace.trc', default);
GO

Vedere anche

Riferimento

sp_trace_generateevent (Transact-SQL)

sp_trace_setevent (Transact-SQL)

sp_trace_setfilter (Transact-SQL)

sp_trace_setstatus (Transact-SQL)