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.
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)