適用於:SQL Server
Azure SQL Database
Azure SQL 受控實例
sys.fn_MSxe_read_event_stream 傳回二進位資料,供 QueryableXEventData .NET 類別內部使用。 SQL Server Management Studio (SSMS) 中的擴充事件 UI 會使用此類別來讀取事件會話資料。
若要檢視人類可讀的事件資料,請使用下列其中一項,而不是直接呼叫 sys.fn_MSxe_read_event_stream :
- SSMS 中的擴充事件 UI。
- sys.fn_xe_file_target_read_file 表格值函數。
語法
sys.fn_MSxe_read_event_stream ( source , source_option )
引數
源
函數傳回的事件資料的特定來源。 來源 是 nvarchar(260), 沒有預設值。
根據source_option的值,來源的解譯方式會有所不同:
| source_option | 來源解釋 |
|---|---|
0 |
來源 是已啟動事件階段作業的名稱。 |
1 |
來源 是要讀取的事件會話記錄檔的路徑。 與本端檔案系統中的檔案搭配使用時, 來源 必須包含事件階段作業日誌檔的名稱,而且可以包含 * 為萬用字元。搭配 Azure 儲存體容器中的 Blob 使用時, 來源 是由兩個部分串連所建構的 HTTP URL: 1. Azure 儲存體儲存體容器的路徑,後面接著斜線 ( /)。2. 容器中應讀取的 blob 名稱的通用前置詞。 例如,使用 https://<storage-account-name>.blob.core.windows.net/container-name>/xe_session as source 會從名稱開頭 xe_session為 的所有 Blob 擷取資料,且不論 Blob 名稱的其餘部分 (包括副檔名)。 無法指定萬用字元。 允許存取 Azure 儲存體容器的認證必須存在。 |
source_option
決定事件資料來源類型的選項。 可能的值為:
| 價值觀 | 描述 |
|---|---|
0 |
從已啟動事件階段作業的 event_stream 目標傳回事件資料。 該函數無限期地執行,並在會話產生時傳回新的事件資料。 |
1 |
從 來源指定的擴充事件記錄檔傳回事件資料。 |
傳回的資料表
| 資料行名稱 | 資料類型 | 描述 |
|---|---|---|
| 型別 | int | 事件類型。 不可為 Null。 |
| 資料 | 圖像 | 二進位事件資料。 可為 Null。 |