sys.fn_xe_file_target_read_file (Transact-SQL)

Legge file creati dalla destinazione asincrona dei file degli eventi estesi. In formato XML viene restituito un file per riga.

Icona di collegamento a un argomentoConvenzioni della sintassi Transact-SQL

Sintassi

sys.fn_xe_file_target_read_file ( path, mdpath, initial_file_name, initial_offset )

Argomenti

  • path
    Percorso dei file da leggere. path può contenere caratteri jolly e può includere il nome di un file. path è di tipo nvarchar(260) e non prevede alcun valore predefinito.

  • mdpath
    Percorso del file di metadati che corrisponde al file oppure ai file specificati dall'argomento path. mdpath è di tipo nvarchar(260) e non prevede alcun valore predefinito.

  • initial_file_name
    Primo file da cui eseguire la lettura path. initial_file_name è di tipo nvarchar(260) e non prevede alcun valore predefinito. Se come argomento viene specificato null, vengono letti tutti i file trovati in path.

    [!NOTA]

    initial_file_name e initial_offset sono argomenti accoppiati. Se si specifica un valore per uno dei due argomenti, è necessario specificare un valore anche per l'altro.

  • initial_offset
    Offset nel primo file da cui iniziare la lettura. initial_offset è di tipo bigint. Se come argomento viene specificato null, verrà letto il file intero.

Tabella restituita

Nome colonna

Tipo di dati

Descrizione

module_guid

uniqueidentifier

GUID del modulo dell'evento. Non ammette valori Null.

package_guid

uniqueidentifier

GUID del pacchetto dell'evento. Non ammette valori Null.

object_name

nvarchar(256)

Nome dell'evento. Non ammette valori Null.

event_data

nvarchar(max)

Contenuto dell'evento in formato XML. Non ammette valori Null.

file_name

nvarchar(260)

Nome del file che contiene l'evento. Non ammette valori Null.

file_offset

bigint

Offset del blocco nel file che contiene l'evento. Non ammette valori Null.

Autorizzazioni

È richiesta l'autorizzazione VIEW SERVER STATE nel server.

Esempi

A. Recupero di dati da destinazioni di file

Nell'esempio seguente vengono restituite tutte le righe di tutti i file. Nell'esempio le destinazioni di file e i metafile si trovano nella cartella della traccia in C:\unità.

select * from sys.fn_xe_file_target_read_file('C:\traces\*.xel', 'C:\traces\metafile.xem', null, null)