タイム シリーズ ID の選択に関するベスト プラクティス
注意
Time Series Insights (TSI) サービスは、2025 年 3 月以降はサポートされなくなります。 できるだけ早く既存の TSI 環境を代替ソリューションに移行することを検討してください。 サポートの終了と移行の詳細については、こちらのドキュメントを参照してください。
この記事では、Azure Time Series Insights Gen2 環境での時系列 ID の重要性と、それを選択するためのベスト プラクティスをまとめています。
タイム シリーズ ID の選択
適切な時系列 ID を選択することが重要です。 タイム シリーズ ID の選択は、データベースでのパーティション キーの選択のようなものです。 これは、Azure Time Series Insights Gen2 環境を作成する場合に必要です。
時系列 ID の詳細な説明については、環境のプロビジョニングに関するチュートリアルをご覧ください。 2 つの異なる JSON テレメトリ ペイロードの例と、それぞれの適切な時系列 ID の選択を表示します。
重要
時系列 ID：
- "大文字と小文字の区別がある文字列" プロパティ： 大文字と小文字の区別は、検索、比較、更新、およびパーティション化で使用されます。
- 変更できません プロパティ： 一度作成した後は変更できません。
ヒント
イベント ソースが IoT ハブである場合、時系列 ID は iothub-connection-device-id になる可能性があります。IoT Plug and Play デバイス モデルを使用する予定がある場合、またはコンポーネントなしでそれらを使用している場合は、将来必要な場合に備え、複合キーの一部として dt-subject を含める必要があります。
従うべき主なベストプラクティスは、次のとおりです：
- 多数 (たとえば数百から数千) の個別の値を備えたパーティション キーを選択します。 多くの場合、これは JSON のデバイス ID、センサー ID、またはタグ ID である可能性があります。
- タイム シリーズ ID は、タイム シリーズ モデルのリーフ ノード レベルで一意である必要があります。
- 時系列 ID のプロパティ名文字列の文字制限は、128 です。 時系列 ID のプロパティ値の場合、文字数の制限は 1024 です。
- 時系列 ID の一意のプロパティ値がない場合は、null 値として扱われ、一意性制約と同じルールに従います。
- 時系列 ID が複雑な JSON オブジェクト内で入れ子になっている場合、プロパティ名を指定するとき、イングレス フラット化ルールに従います。 例 B を確認してください。
- 時系列 ID として最大 3 個のキー プロパティも選択できます。 これらの組み合わせは、時系列 ID を表す複合キーになります。
Note
3 個のキー プロパティは文字列である必要があります。 一度に 1 つのプロパティではなく、この複合キーに対してクエリを実行する必要があります。
複数のキープロパティを選択する
次のシナリオでは、時系列 ID として複数のキー プロパティを選択する場合について説明します。
例 1:一意のキーを持つ時系列 ID
- 従来の保有機材の資産があります。 それぞれには一意のキーがあります。
- 1 つの車両は、プロパティ deviceId によって一意に識別されます。 別の車両では、一意のプロパティは objectId です。 どの車両にも、他の車両の一意プロパティは含まれません。 この例では、一意キーとして 2 つのキー deviceId と objectId を選択します。
- null 値が受け付けられ、イベント ペイロードにプロパティが存在しない場合は null 値としてカウントされます。 またこれは、2 つのイベント ソースにデータを送信し、各イベント ソースのデータが一意の時系列 ID を持っている場合の処理にも適した方法です。
例 2:複合キーを持つ時系列 ID
- 資産の同じフリート内で複数のプロパティが一意である必要があります。
- あなたはスマート ビルディングのメーカーで、すべての部屋にセンサーをデプロイしています。 通常、各部屋の sensorId の値は同じです。 例として、sensor1、sensor2、および sensor3 となります。
- 建物には、プロパティ flrRm のサイト間で、重複しているフロア番号と部屋番号があります。 これらの数値には、1a、2b、3a などの値があります。
- プロパティ location には、Redmond、Barcelona、Tokyo などの値が含まれています。 一意性を作成するには、時系列 ID のキーとして、3 つのプロパティ sensorId、flrRm、location を指定します。
未加工イベントの例:
{
"sensorId": "sensor1",
"flrRm": "1a",
"location": "Redmond",
"temperature": 78
}
Azure portal では、次のようにして、複合キーを入力できます：
注意
Azure portal では、複数のプロパティ名をコンマで区切って 1 つのテキストボックスに入力しないでください。このように入力すると、コンマが含まれる単一のプロパティ名として処理されます。 各プロパティ名を独自のテキストボックスに入力してください。
次のステップ
JSON のフラット化とエスケープのルールを読み、イベントの格納方法を理解する。