共用方式為


支援的數據類型

備註

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

下表列出 Azure 時間序列深入解析 Gen2 支援的數據類型

數據類型 說明 範例 時間序列運算式語法 Parquet 的屬性欄位名稱
bool 具有兩種狀態之一的數據類型: truefalse "isQuestionable" : true $event.isQuestionable.Bool$event['isQuestionable'].Bool isQuestionable_bool
datetime 表示時間的瞬間,通常以一天的日期和時間表示。 以 ISO 8601 格式表示。 Datetime 屬性一律以 UTC 格式儲存。 時區位移如果格式正確,將會套用,然後數值會以UTC格式儲存。 如需環境時間戳屬性和日期時間位移的詳細資訊,請參閱本節 "eventProcessedLocalTime": "2020-03-20T09:03:32.8301668Z" 如果 「eventProcessedLocalTime」 是事件來源時間戳: $event.$ts。 如果是另一個 JSON 屬性: $event.eventProcessedLocalTime.DateTime$event['eventProcessedLocalTime'].DateTime eventProcessedLocalTime_datetime
雙倍 雙精度64位元數字 "value": 31.0482941 $event.value.Double$event['value'].Double value_double
帶正負號的64位整數 "value" : 31 $event.value.Long$event['value'].Long value_long
字串 文字值必須包含有效的UTF-8。 Null 和空字串的處理方式相同。 "site": "DIM_MLGGG" $event.site.String$event['site'].String site_string
動態 由陣列或屬性包(字典)組成的複雜(非基本型別) 類型。 目前,只有不包含 TS 識別碼或時間戳屬性的基本型別陣列或物件陣列的字串化 JSON 會儲存為動態類型。 請閱讀本文,以了解物件將如何被扁平化處理,以及陣列可能會被展開。 只有在 Time Series Insights Explorer 中選取 Explore Events 以檢視原始事件,或透過 GetEvents 查詢 API 用戶端解析,才能存取以此類型儲存的承載屬性。 "values": "[197, 194, 189, 188]" 尚未支援參考時間序列表示式中的動態類型 values_dynamic

備註

支援 64 位整數值,但由於 JavaScript 限制,Azure 時間序列深入解析 Explorer 可以安全地表示的最大數位是 9,007,199,254,740,991 (2^53-1)。 如果您使用上述資料模型中的數位,您可以藉由建立 時間序列模型變數轉換 值來減少大小。

備註

字串 類型不能為 null:

  • 時間序列表示式 (TSX) 在時間序列查詢表示,將空字串 (''') 的值與 NULL 相比較,其行為方式相同:$event.siteid.String = NULL相當於 $event.siteid.String = ''
  • 即使原始事件包含空字串,API 仍可能會傳回 NULL 值。
  • 請勿相依於 String 數據行中的 NULL 值來執行比較或評估,請將其視為空字串。

傳送混合數據類型

您的 Azure 時間序列分析 Gen2 環境是強類型化。 如果裝置或標籤傳送不同類型裝置屬性的數據,值會儲存在兩個分隔的數據行中,而且 在 API 呼叫中定義時間序列模型變數運算式時,應該使用 coalesce() 函 式。

Azure 時間序列深入解析 Explorer 提供一種方法,自動合併相同裝置屬性的各個欄。 在下列範例中,感測器會傳送一個屬性 PresentValue,它可以是 Long 或 Double。 若要查詢 PresentValue 屬性的所有預存值(不論數據類型為何),請選擇 PresentValue (Double | Long),系統會自動為您整合數據行。

Explorer 自動合併

對象和陣列

您可以在事件承載中傳送複雜類型,例如對象和陣列。 巢狀物件將會被扁平化,陣列將會依據您的環境配置和 JSON 結構儲存為 dynamic 或被扁平化以產生多個事件。 若要深入瞭解 JSON 扁平化和跳脫規則

後續步驟