タイム シリーズ ID の選択に関するベスト プラクティス

Note

Time Series Insights サービスは、2024 年 7 月 7 日に廃止されます。 できるだけ早く既存の環境を代替ソリューションに移行することを検討してください。 サポートの終了と移行の詳細については、こちらのドキュメントを参照してください。

この記事では、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 では、次のようにして、複合キーを入力できます：

Note

Azure portal では、複数のプロパティ名をコンマで区切って 1 つのテキストボックスに入力しないでください。このように入力すると、コンマが含まれる単一のプロパティ名として処理されます。 各プロパティ名を独自のテキストボックスに入力してください。

次のステップ

• JSON のフラット化とエスケープのルールを読み、イベントの格納方法を理解する。

• Azure Time Series Insights Gen2 環境を計画します。