從 Azure 時間序列深入解析 Gen2 中查詢資料
注意
2025 年 3 月之後，時間序列深入解析 (TSI) 服務將不再受到支援。 請考慮盡快將現有 TSI 環境移轉至替代解決方案。 如需淘汰和移轉的詳細資訊，請造訪我們的文件。
Azure 時間序列深入解析 Gen2 允許透過公用介面 API，針對事件和儲存在環境中的中繼資料進行資料查詢。 Azure 時間序列深入解析 TSI 總管也會使用這些 API。
Azure 時間序列深入解析 Gen2 中提供了三個主要 API 類別：
- 環境 API：這些 API 會啟用 Azure 時間序列深入解析 Gen2 環境本身的查詢。 這些可以用來收集呼叫者有權存取的環境清單，以及環境中繼資料。
- 時間序列模型查詢 (TSM-Q) API：在儲存於環境時間序列模型的中繼資料上啟用建立、讀取、更新和刪除 (CRUD) 作業。 這些可以用來存取和編輯執行個體、類型和階層。
- 時間序列查詢 (TSQ) API：啟用擷取遙測或事件資料，因為此資料是從來源提供者記錄，並使用進階純量和彙總函式來啟用資料的效能計算和彙總。
Azure 時間序列深入解析 Gen2 使用豐富的字串型運算式語言 (時間序列運算式 (TSX))，表示時間序列變數中的計算。
Azure 時間序列深入解析 Gen2 API 概觀
支援下列核心 API。
環境 API
- 取得環境 API：傳回呼叫者有權存取的環境清單。
- 取得環境可用性 API：傳回事件時間戳記
$ts上的事件計數分佈。 此 API 會協助判斷環境中是否有任何事件，方法是傳回分成時間間隔的事件計數 (如果有的話)。 - 取得事件結構描述 API：傳回指定搜尋範圍的事件結構描述中繼資料。 此 API 可協助擷取指定搜尋範圍的結構描述中可用的所有中繼資料和屬性。
時間序列模型查詢 (TSM-Q) API
這些 API 大部分都支援批次執行作業，以在多個時間序列模型實體上啟用批次 CRUD 作業：
- 模型設定 API：對環境的預設類型和模型名稱啟用 GET 和 PATCH。
- 類型 API：在時間序列類型及其相關聯的變數上啟用 CRUD。
- 階層 API：在時間序列階層及其相關聯的欄位路徑上啟用 CRUD。
- 執行個體 API：在時間序列執行個體及其相關聯的執行個體欄位上啟用 CRUD。 此外，執行個體 API 也支援下列作業：
時間序列查詢 (TSQ) API
這些 API 可跨多層式儲存解決方案中的兩個存放區 (暖與冷) 取得。
取得事件 API：啟用查詢和擷取原始事件和相關聯的事件時間戳記，因為這些事件和時間戳記從來源提供者記錄在 Azure 時間序列深入解析 Gen2 中。 此 API 允許擷取指定時間序列識別碼和搜尋範圍的原始事件。 此 API 支援分頁，以擷取所選輸入的完整回應資料集。
重要
作為 JSON 壓平合併和逸出規則後續變更的一部分，陣列會儲存為動態類型。 儲存為此類型的承載屬性只能透過取得事件 API 存取。
取得系列 API：啟用查詢和擷取計算值和相關聯的事件時間戳記，方法是在原始事件上套用變數所定義的計算。 這些變數可以在時間序列模型中定義，或在查詢中以內嵌方式提供。 此 API 支援分頁，以擷取所選輸入的完整回應資料集。
彙總系列 API：啟用查詢和擷取彙總值和相關聯的間隔時間戳記，方法是在原始事件上套用變數所定義的計算。 這些變數可以在時間序列模型中定義，或在查詢中以內嵌方式提供。 此 API 支援分頁，以擷取所選輸入的完整回應資料集。
針對指定的搜尋範圍和間隔，此 API 會針對時間序列識別碼，每個變數傳回每個間隔的彙總回應。 回應資料集中的間隔數目，其計算方式是計算 Epoch 刻度 (自 Unix Ep och - 1970 年 1 月 1 日起經過的毫秒數)，並將刻度除以查詢中指定的間隔範圍大小。
回應集中傳回的時間戳記屬於左間隔界限，而不屬於間隔中取樣的事件。
選取存放區類型
上述 API 只能在單一呼叫中針對兩種儲存體類型 (暖與冷) 之一執行。 查詢 URL 參數用來指定查詢應在其上執行的存放區類型。
如果未指定任何參數，預設會在冷存放區上執行查詢。 如果查詢跨越冷和暖存放區重疊的時間範圍，建議將查詢路由至冷存放區，以獲得最佳體驗，因為暖存放區只會包含部分資料。
Azure 時間序列深入解析總管和 Power BI 連接器會呼叫上述 API，並會自動選取相關的正確 storeType 參數。
下一步
- 深入了解可以在時間序列模型中定義的不同變數。
- 深入了解如何從 Azure 時間序列深入解析總管查詢資料。