支援的資料類型
注意
2025 年 3 月之後，時間序列深入解析 (TSI) 服務將不再受到支援。 請考慮盡快將現有 TSI 環境移轉至替代解決方案。 如需淘汰和移轉的詳細資訊，請造訪我們的文件。
下表列出 Azure 時間序列深入解析 Gen2 支援的資料類型
| 資料類型 | 描述 | 範例 | 時間序列運算式語法 | Parquet 中的屬性資料行名稱 |
|---|---|---|---|---|
| bool | 具有下列兩種狀態之一的資料類型：true 或 false。 |
"isQuestionable" : true |
$event.isQuestionable.Bool 或 $event['isQuestionable'].Bool |
isQuestionable_bool |
| datetime | 表示時間的瞬間，通常以一天的日期和時間表示。 以 ISO 8601 格式表示。 日期時間屬性一律是以 UTC 格式儲存。 如果格式正確，則會套用時區位移，然後套用以 UTC 儲存的值。 如需環境時間戳記屬性和日期時間位移的詳細資訊，請參閱本節 | "eventProcessedLocalTime": "2020-03-20T09:03:32.8301668Z" |
如果 "eventProcessedLocalTime" 是事件來源時間戳記：$event.$ts。 如果其是另一個 JSON 屬性：$event.eventProcessedLocalTime.DateTime 或 $event['eventProcessedLocalTime'].DateTime |
eventProcessedLocalTime_datetime |
| double | 雙精確度 64 位元數字 | "value": 31.0482941 |
$event.value.Double 或 $event['value'].Double |
value_double |
| long | 帶正負號的 64 位元整數 | "value" : 31 |
$event.value.Long 或 $event['value'].Long |
value_long |
| string | 文字值必須包含有效的 UTF-8。 Null 和空字串的處理方式相同。 | "site": "DIM_MLGGG" |
$event.site.String 或 $event['site'].String |
site_string |
| dynamic | 由陣列或屬性包 (字典) 組成的複雜 (非基本) 類型。 目前只有物件基本類型或陣列的字串化 JSON 陣列不包含 TS 識別碼，或時間戳記屬性會儲存為動態。 請閱讀這篇文章，以了解如何壓平合併物件，而且可能會取消註冊陣列。 只有在時間序列深入解析總管中選取 Explore Events 以檢視原始事件，或透過 GetEvents 查詢 API 進行用戶端剖析，才能存取儲存為此類型的承載屬性。 |
"values": "[197, 194, 189, 188]" |
尚未支援參考時間序列運算式中的動態類型 | values_dynamic |
注意
支援 64 位元整數值，但由於 JavaScript 限制，Azure 時間序列深入解析總管可以安全地表示的最大數字為 9,007,199,254,740,991 (2^53-1)。 如果您在資料模型中使用的數字超過此數字，您可以建立時間序列模型變數並轉換 值來減少大小。
注意
字串類型不可為 Null：
- 以時間序列查詢表示的時間序列運算式 (TSX) 會將空字串 ('') 的值與 Null 進行比較，其會以相同方式運作：
$event.siteid.String = NULL相當於$event.siteid.String = ''。 - 即使原始事件包含了空字串，API 仍可能會傳回 Null 值。
- 請不要依賴 [字串] 資料行中的 Null 值來執行比較或評估，並以處理空字串的相同方式處理這些值。
傳送混合的資料類型
Azure 時間序列深入解析 Gen2 環境是具強類型的環境。 如果裝置或標籤針對裝置屬性傳送不同類型的資料，值將會儲存在兩個不同的資料行中，而且在 API 呼叫中定義時間序列模型變數運算式時，應該使用 coalesce() 函式。
Azure 時間序列深入解析總管提供一種方式，以自動聯合相同裝置屬性的個別資料行。 在下列範例中，感應器會傳送可以是 Long 或 Double 的 PresentValue 屬性。 若要查詢 PresentValue 屬性的所有儲存值 (不論資料類型為何)，請選擇 PresentValue (Double | Long)，而且系統會為您聯合資料行。
物件和陣列
您可能會傳送複雜類型 (例如物件和陣列) 作為事件裝載的一部分。 巢狀物件會壓平合併，而陣列會儲存為 dynamic 或壓平合併，以產生多個事件，取決於您的環境設定和 JSON 圖形。 若要深入了解 JSON 壓平合併和逸出規則
下一步
閱讀 JSON 壓平合併和逸出規則，了解事件的儲存方式。
了解環境的輸送量限制
了解事件來源來擷取串流資料。