sys.fn_trace_gettable (Transact-SQL)

  • Articolo

Si applica a:SQL Server

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

Importante

Questa funzionalità verrà rimossa nelle versioni future di SQL Server. Evitare di usare questa funzionalità in un nuovo progetto di sviluppo e prevedere interventi di modifica nelle applicazioni in cui è attualmente implementata. In alternativa, usare Eventi estesi.

Convenzioni di sintassi Transact-SQL

Sintassi

  
fn_trace_gettable ( 'filename' , number_files )

Argomenti

'filename'
Specifica il file di traccia iniziale da leggere. filename è nvarchar(256), senza impostazione predefinita.

number_files
Specifica il numero di file di rollover da leggere. Questo numero include il file iniziale specificato nel nome file. number_files è un valore int.

Osservazioni:

Se number_files viene specificato come predefinito, 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 altre informazioni, vedere sp_trace_setevent (Transact-SQL).

Tenere presente che la funzione fn_trace_gettable non caricherà i file di rollover (quando questa opzione viene specificata usando l'argomento number_files ) in cui il nome del file di traccia originale termina con un carattere di sottolineatura e un valore numerico. Questo non si applica al carattere di sottolineatura e al numero aggiunti automaticamente quando un file esegue il roll over. Come soluzione alternativa, è possibile rinominare i file di traccia per rimuovere i caratteri di sottolineatura nel nome 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

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

Vedi anche

sp_trace_generateevent (Transact-SQL)
sp_trace_setevent (Transact-SQL)
sp_trace_setfilter (Transact-SQL)
sp_trace_setstatus (Transact-SQL)