Condividi tramite


sys.fn_MSxe_read_event_stream (Transact-SQL)

Si applica a:SQL Server, Database SQL di Azure e Istanza gestita di SQL di Azure.

sys.fn_MSxe_read_event_stream restituisce i dati binari per l'uso interno dalla classe QueryableXEventData .NET. L'interfaccia utente degli eventi estesi in SQL Server Management Studio (SSMS) usa questa classe per leggere i dati della sessione eventi.

Per visualizzare i dati degli eventi leggibili, usare una delle opzioni seguenti anziché chiamare sys.fn_MSxe_read_event_stream direttamente:

Convenzioni relative alla sintassi Transact-SQL

Sintassi

sys.fn_MSxe_read_event_stream ( source , source_option )

Argomenti

origine

Origine specifica dei dati dell'evento restituiti dalla funzione . L'origine è nvarchar(260) senza impostazione predefinita.

L'origine viene interpretata in modo diverso a seconda del valore di source_option:

source_option Interpretazione dell'origine
0 Source è il nome di una sessione evento avviata.
1 L'origine è il percorso dei file di log della sessione eventi da leggere.

Se usato con i file nel file system locale, l'origine deve includere il nome di un file di log della sessione eventi e può contenere * come carattere jolly.

Se usato con i BLOB in un contenitore di Archiviazione di Azure, l'origine è un URL HTTP costruito dalla concatenazione di due parti:

1. Percorso di un contenitore di archiviazione di Archiviazione di Azure, seguito da una barra (/).
2. Un prefisso comune per i nomi dei BLOB nel contenitore da leggere.

Ad esempio, l'uso di https://<storage-account-name>.blob.core.windows.net/container-name>/xe_session come origine recupera i dati da tutti i BLOB con nomi che iniziano con xe_sessione indipendentemente dal resto del nome del BLOB, inclusa l'estensione. Non è possibile specificare caratteri jolly. Deve esistere una credenziale che consente l'accesso al contenitore di Archiviazione di Azure.

source_option

Opzione che determina il tipo dell'origine dati dell'evento. I valori possibili sono:

Value Descrizione
0 Restituisce i dati dell'evento dalla destinazione event_stream di una sessione evento avviata. La funzione viene eseguita per un periodo illimitato, restituendo nuovi dati dell'evento man mano che la sessione lo produce.
1 Restituisce i dati dell'evento dai file di log eventi estesi specificati dall'origine.

Tabella restituita

Nome colonna Tipo di dati Descrizione
type Int Tipo di evento. Non ammette i valori NULL.
data image Dati dell'evento binario. Ammette i valori Null.