共用方式為


sys.fn_MSxe_read_event_stream (Transact-SQL)

適用於:SQL ServerAzure SQL DatabaseAzure SQL 受控實例

sys.fn_MSxe_read_event_stream 傳回二進位資料,供 QueryableXEventData .NET 類別內部使用。 SQL Server Management Studio (SSMS) 中的擴充事件 UI 會使用此類別來讀取事件會話資料。

若要檢視人類可讀的事件資料,請使用下列其中一項,而不是直接呼叫 sys.fn_MSxe_read_event_stream

Transact-SQL 語法慣例

語法

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。