sys.fn_xe_file_target_read_file (Transact-SQL)

  • Articolo

Legge file creati dalla destinazione asincrona dei file degli eventi estesi. Viene restituito un evento per riga in formato XML.

Nota di attenzioneAttenzione

In SQL Server 2008 e SQL Server 2008 R2 vengono accettati i risultati della traccia generati in formato XEL e XEM. Gli eventi estesi di SQL Server 2012 supportano solo i risultati della traccia in formato XEL. È consigliabile utilizzare SQL Server Management Studio per leggere i risultati della traccia in formato XEL.

Icona di collegamento a un argomento Convenzioni 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.

    [!NOTA]

    In SQL Server 2012 non è richiesto il parametro mdpath. È tuttavia disponibile per la compatibilità con i file di log generati in versioni precedenti di SQL Server.

  • initial_file_name
    Primo file di cui eseguire la lettura da 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
    Utilizzato per specificare l'ultimo offset letto precedentemente e consente di ignorare tutti gli eventi fino all'offset (incluso). L'enumerazione degli eventi inizia dopo l'offset specificato. 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);

Vedere anche

Riferimento

Viste a gestione dinamica degli eventi estesi

Viste del catalogo degli eventi estesi (Transact-SQL)

Concetti

Eventi estesi