sys.fn_trace_gettable (Transact-SQL)sys.fn_trace_gettable (Transact-SQL)

SI APPLICA A: sìSQL Server (a partire dalla versione 2008) noDatabase SQL di Azure noAzure SQL Data Warehouse noParallel Data Warehouse APPLIES TO: yesSQL Server (starting with 2008) noAzure SQL Database noAzure SQL Data Warehouse noParallel Data Warehouse

Restituisce il contenuto di uno o più file di traccia in formato tabulare.Returns the content of one or more trace files in tabular form.

Importante

Questa funzionalità è in manutenzione e potrebbe essere rimossa in una delle prossime versioni di Microsoft SQL Server.This feature is in maintenance mode and may be removed in a future version of Microsoft SQL Server. Evitare di usare questa funzionalità in un nuovo progetto di sviluppo e prevedere interventi di modifica nelle applicazioni in cui è attualmente implementata.Avoid using this feature in new development work, and plan to modify applications that currently use this feature. In alternativa, usare Eventi estesi. Use Extended Events instead.

Icona di collegamento a un argomentoConvenzioni della sintassi Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SintassiSyntax

  
fn_trace_gettable ( 'filename' , number_files )  

ArgomentiArguments

«filename»'filename'
Specifica il file di traccia iniziale da leggere.Specifies the initial trace file to be read. nome file viene nvarchar(256), non prevede alcun valore predefinito.filename is nvarchar(256), with no default.

number_filesnumber_files
Specifica il numero di file di rollover da leggere.Specifies the number of rollover files to be read. Questo numero include il file iniziale specificato filename.This number includes the initial file specified in filename. number_files è un int.number_files is an int.

NoteRemarks

Se number_files è specificato come predefinita, fn_trace_gettable legge tutti i file di rollover fino a quando non raggiunge la fine della traccia.If number_files is specified as default, fn_trace_gettable reads all rollover files until it reaches the end of the trace. fn_trace_gettable restituisce una tabella con tutte le colonne valide per la traccia specificata.fn_trace_gettable returns a table with all the columns valid for the specified trace. Per altre informazioni, vedere sp_trace_setevent (Transact-SQL).For more information, see sp_trace_setevent (Transact-SQL).

Tenere presente che la funzione fn_trace_gettable non caricherà file di rollover (quando questa opzione viene specificata tramite il number_files argomento) in cui il nome di file di traccia originale termina con un carattere di sottolineatura e un valore numerico.Be aware that the fn_trace_gettable function will not load rollover files (when this option is specified by using the number_files argument) where the original trace file name ends with an underscore and a numeric value. 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.(This does not apply to the underscore and number that are automatically appended when a file rolls over.) As a workaround, you can rename the trace files to remove the underscores in the original file name. 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 da TraceOct5.trc e TraceOct5_1.trc.For example, if the original file is named Trace_Oct_5.trc and the rollover file is named Trace_Oct_5_1.trc, you can rename the files to TraceOct5.trc and TraceOct5_1.trc.

Questa funzione consente di leggere una traccia ancora attiva nell'istanza in cui viene eseguita.This function can read a trace that is still active on the instance on which it is executed.

PermissionsPermissions

È necessario disporre dell'autorizzazione ALTER TRACE nel server.Requires ALTER TRACE permission on the server.

EsempiExamples

A.A. Utilizzo di fn_trace_gettable per importare righe da un file di tracciaUsing fn_trace_gettable to import rows from a trace file

Nell'esempio seguente viene chiamato fn_trace_gettable all'interno della clausola FROM di un'istruzione SELECT...INTO.The following example calls fn_trace_gettable inside the FROM clause of a SELECT...INTO statement.

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

B.B. Utilizzo di fn_trace_gettable per restituire una tabella con una colonna IDENTITY che può essere caricata in una tabella di SQL ServerUsing fn_trace_gettable to return a table with an IDENTITY column that can be loaded into a SQL Server table

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.The following example calls the function as part of a SELECT...INTO statement and returns a table with an IDENTITY column that can be loaded into the table 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 ancheSee Also

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