Azure portal を使用して Azure Time Series Insights Gen1 環境の参照データセットを作成する

[アーティクル]
06/01/2023

Note

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

注意事項

これは Gen1 の記事です。

この記事では、Azure Time Series Insights 環境に参照データセットを追加する方法について説明します。参照データは、ソースデータに結合することにより値を増幅するのに役立ちます。

参照データセットは、イベントソースからのイベントを増幅する項目の集まりです。イベントソースから受信した各イベントは、Azure Time Series Insights のイングレスエンジンによって、指定した参照データセット内の対応するデータ行と結合されます。こうして増幅されたイベントをクエリで利用することができます。この結合操作は、参照データセットに定義されている主キー列に基づいて行われます。

参照データは、遡及的に結合されることはありません。そのため、データが構成されてアップロードされると、現在および将来のイングレスデータのみが対応付けられ、参照日付セットに結合されます。

ビデオ

Time Series Insight の参照データモデルについて説明します。

参照データセットを追加する

Azure portal にサインインします。
既存の Azure Time Series Insights 環境を見つけます。 Azure Portal の左側のメニューにある [すべてのリソース] を選択します。 Azure Time Series Insights 環境を選択します。
[概要] ページを選択します。ページの上部付近にある [Essentials] セクションを展開して、[Time Series Insights Explorer の URL] を見つけ、リンクを開きます。

お使いの Azure Time Series Insights 環境に対するExplorer を表示します。
Azure Time Series Insights Explorer で環境セレクターを展開します。アクティブな環境を選択します。 Explorer ページの右上にある参照データアイコンを選択します。
[+ データセットの追加] ボタンをクリックして、新しいデータセットの追加を開始します。
[新しい参照データセット] ページで、データの形式を選択します。
- [CSV](コンマ区切りのデータ) を選択します。最初の行は、ヘッダー行として扱われます。
- JavaScript オブジェクト表記法 (JSON) 形式のデータの場合は [JSON 配列] を選択します。
次のいずれかの方法を使用して、データを指定します。
- データをテキストエディターに貼り付けます。その後、[参照データの解析] ボタンをクリックします。
- [ファイルの選択] ボタンをクリックして、ローカルテキストファイルからデータを追加します。
たとえば、次のように CSV データを貼り付けます。

たとえば、次のように JSON 配列データを貼り付けます。

データ値の解析中にエラーが発生した場合は、ページの下部に赤色でエラーが表示されます (たとえば、CSV parsing error, no rows extracted)。
データが正常に解析されると、データグリッドが表示され、データを表す行と列が表示されます。データグリッドをレビューし、内容が正しいこと確認してください。
各列をレビューして、仮定されたデータ型を理解し、必要であればデータ型を変更します。列見出しにあるデータ型のシンボルを選択します。# はdouble (数値データ)、T|F はブール型、Abc は文字列を表します。
必要であれば、列見出しの名前を変更します。キー列の名前は、イベントソース内の対応するプロパティに結合させるために必要です。

重要

参照データのキー列名が、大文字小文字の区別も含め、受信データへのイベント名と正確に一致することを確認してください。非キー列の名前は、受信データを対応する参照データの値で増幅するために使用されます。
必要であれば、[Filter the rows...]\(行をフィルター...\) フィールドに値を入力して、特定の行をレビューします。フィルターはデータをレビューするのに便利ですが、データのアップロード中には適用されません。
データグリッドの上の [データセット名] フィールドに値を入力して、データセットに名前を付けます。
データグリッドの上にあるドロップダウンリストを選択して、データセット内の [主キー] 列を指定します。

(オプション)+ ボタンを選択して、セカンダリキー列を複合主キーとして追加します。選択を元に戻す必要がある場合は、ドロップダウンリストから空の値を選択して、セカンダリキーを削除します。
データをアップロードするには、[アップロード] ボタンをクリックします。

完了したアップロードが確認され、[データセットが正常にアップロードされました] というメッセージが表示されます。

警告

参照データセット間で共有されている列またはプロパティは、重複したプロパティ名 アップロードエラーが表示されます。このエラーが発生すると、参照データセットを正常にアップロードすることはできません。重複するプロパティ名を共有する行を結合することによって削除できます。
[行の追加]、[行の一括インポート] または [列の追加] を選択し、必要に応じて参照データの値をさらに追加します。

重要

一意のキーを別の行と共有する行は、その一意のキーを共有する最後に追加された行によってオーバーライドされる列を含みます。

Note

追加された行は、長方形である必要はありません - 参照データセット内の他のエントリの列の数が少なくなったり、大きくたり、変化したりする可能性があります。