サポートされているデータ型
手記
Time Series Insights サービスは、2024 年 7 月 7 日に廃止されます。 既存の環境をできるだけ早く別のソリューションに移行することを検討してください。 非推奨と移行の詳細については、
次の表に、Azure Time Series Insights Gen2 でサポートされるデータ型の一覧を示します。
| データ型 | 説明 | 例 | 時系列表現構文の | Parquet のプロパティ列名 |
|---|---|---|---|---|
| ブール |
true または falseの 2 つの状態のいずれかを持つデータ型。 |
"isQuestionable" : true |
$event.isQuestionable.Bool または $event['isQuestionable'].Bool |
isQuestionable_bool |
| の日時を |
一時的な時間を表します。通常は、日付と時刻として表されます。
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 ID またはタイムスタンプ プロパティを含まないプリミティブまたはオブジェクトの配列の文字列化された JSON 配列のみが動的として格納されます。 オブジェクトがどのようにフラット化され、配列がどのように展開されるかを理解するには、この 記事 を参照してください。 この種類として格納されているペイロード プロパティにアクセスするには、Time Series Insights エクスプローラーで Explore Events を選択して生のイベントを表示するか、クライアント側の解析用の GetEvents クエリ API を使用します。 |
"values": "[197, 194, 189, 188]" |
タイム シリーズ式での動的型の参照はまだサポートされていません | values_dynamic |
手記
64 ビット整数値がサポートされていますが、Azure Time Series Insights Explorer で安全に表現できる最大の数値は、JavaScript の制限により 9,007,199,254,740,991 (2^53-1) です。 上記のデータ モデルで数値を操作する場合は、
手記
文字列 型は null 許容ではありません。
-
時系列式 (TSX) を 時系列クエリ で表現し、空の文字列 ('') を NULL と比較したとき、同じように動作します。
$event.siteid.String = NULLは$event.siteid.String = ''と同等です。 - API は、元のイベントに空の文字列が含まれていた場合でも、NULL 値を返す場合があります。
- 比較や評価を行うために、文字列 列の NULL 値に依存しないでください。空の文字列と同じように扱います。
混合データ型の送信
Azure Time Series Insights Gen2 環境は厳密に型指定されています。 デバイスまたはタグがデバイス プロパティに対して異なる型のデータを送信する場合、値は 2 つの分離された列に格納され、api 呼び出しでタイム シリーズ モデル変数式を定義するときに coalesce() 関数 使用する必要があります。
Azure Time Series Insights エクスプローラーには、同じデバイス プロパティの個別の列を自動的に結合する方法が用意されています。 次の例では、センサーは Long または Double の両方の PresentValue プロパティを送信します。
PresentValue プロパティの (データ型に関係なく) 格納されているすべての値に対してクエリを実行するには、PresentValue (Double | Long) を選択すると、列が結合されます。
オブジェクトと配列
イベント ペイロードの一部として、オブジェクトや配列などの複合型を送信できます。 入れ子になったオブジェクトはフラット化され、配列は dynamic として格納されるか、またはフラット化されて、環境の構成と JSON の形状に応じて複数のイベントが生成されます。 JSONのフラット化とエスケープ規則について詳しく知りたい方は、をお読みください。