從 Azure 時間序列深入解析 Gen2 查詢資料 (機器翻譯)

注意

時間序列深入解析服務將於 2024 年 7 月 7 日淘汰。請考慮儘快將現有的環境移轉至替代解決方案。如需淘汰和移轉的詳細資訊，請造訪我們的文件。

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：傳回事件時間戳 $ts的事件計數分佈。如果有任何事件存在，此 API 可協助判斷環境中是否有任何事件，方法是傳回中斷為時間間隔的事件計數。
取得事件架構 API：傳回指定搜尋範圍的事件架構元數據。此 API 可協助擷取指定搜尋範圍之架構中可用的所有元數據和屬性。

這些 API 大部分都支援批次執行作業，以在多個時間序列模型實體上啟用批次 CRUD 作業：

模型設定 API：在預設類型和環境模型名稱上啟用 GET 和 PATCH 。
類型 API：在時間序列類型及其相關聯的變數上啟用 CRUD。
階層 API：在時間序列階層及其相關聯的欄位路徑上啟用 CRUD。
實例 API：在時間序列實例及其相關聯的實例字段中啟用 CRUD。此外，Instances API 支援下列作業：
- 搜尋：根據實例屬性，擷取搜尋時間序列實例的部分點擊清單。
- 建議：根據實例屬性搜尋時間序列實例時，搜尋並建議點擊的部分清單。

在多層式儲存解決方案中，這兩個存放區都提供這些 API（暖和冷）。

取得事件 API：從來源提供者記錄在 gen2 Azure 時間序列深入解析時，啟用原始事件的查詢和擷取相關聯的事件時間戳。此 API 允許擷取指定時間序列標識碼和搜尋範圍的原始事件。此 API 支援分頁，以擷取所選輸入的完整響應數據集。

重要

在即將進行的 JSON 扁平化和逸出規則變更中，陣列會儲存為動態類型。儲存為此類型的 承載屬性只能透過取得事件 API 來存取。
取得數列 API：藉由對原始事件套用變數所定義的計算，啟用計算值的查詢和擷取相關聯的事件時間戳。這些變數可以在時間序列模型中定義，或在查詢中內嵌提供。此 API 支援分頁，以擷取所選輸入的完整響應數據集。
匯總數列 API：藉由對原始事件套用變數所定義的計算，啟用匯總值的查詢和擷取相關聯的間隔時間戳。這些變數可以在時間序列模型中定義，或在查詢中內嵌提供。此 API 支援分頁，以擷取所選輸入的完整響應數據集。

針對指定的搜尋範圍和間隔，此 API 會針對時間序列標識碼，針對每個變數傳回每個間隔的匯總回應。響應數據集中的間隔數目是藉由計算 epoch 刻度計算（自 Unix epoch - 1970 年 1 月 1 日起經過的毫秒數），並將刻度除以查詢中指定的間隔範圍大小。

回應集中傳回的時間戳是左間隔界限，而不是間隔中的取樣事件。

上述 API 只能在單一呼叫中針對這兩種儲存類型之一（冷或暖）執行。查詢 URL 參數可用來指定查詢應該執行的存放區類型。

如果未指定任何參數，則查詢預設會在冷存放區上執行。如果查詢跨越同時重疊冷和暖存放區的時間範圍，建議將查詢路由傳送至冷存放區，以獲得最佳體驗，因為暖存放區只會包含部分數據。

Azure 時間序列深入解析 Explorer 和 Power BI Connector 會呼叫上述 API，並會自動選取相關的正確 storeType 參數。