Visual Studio Code のジョブダイアグラムを使用して Azure Stream Analytics のクエリをローカルでデバッグする (プレビュー)

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

ストリーミングジョブで結果が出力されないときや予期しない結果が出力されるときは、多くの場合、トラブルシューティングが必要になります。 Azure Stream Analytics の Visual Studio Code 拡張機能には、ジョブダイアグラム、メトリック、診断ログ、および中間結果が統合されているため、問題の原因をすばやく特定するのに役立ちます。ジョブダイアグラムを使用しながらローカルでクエリをテストすることで、各ステップの中間結果セットとメトリックを調べることができます。

ジョブダイアグラムを使用してクエリをデバッグする

Azure Stream Analytics スクリプトは、入力データを出力データに変換するために使用されます。ジョブダイアグラムには、イベントハブや Azure IoT Hubなどの入力ソースのデータが複数のクエリステップを通して最終的に出力シンクまでどのように流れるかが示されます。各クエリステップは、WITH ステートメントを使用してスクリプトに定義された一時的結果セットにマップされます。各中間結果セット内の各クエリステップのデータとメトリックを表示して、問題の原因を見つけることができます。

Note

このジョブダイアグラムには、1 つのノード内のローカルテストのデータとメトリックのみが示されます。パフォーマンスのチューニングとトラブルシューティングには使用しないでください。

ローカルテストを開始する

このクイックスタートで、Visual Studio Code を使用して Stream Analytics ジョブを作成する方法を確認してください。また、既存のジョブをローカルプロジェクトにエクスポートする方法ついては、こちらを確認してください。入力および出力のための資格情報は、エクスポートされたジョブに対して自動的に設定されます。

ローカルの入力データを使用してクエリをテストする場合は、こちらの手順を実行してください。ライブ入力を使用してテストする場合は、入力を構成してから、次の手順に進んでください。

.asaql スクリプトファイルを開き、[ローカルで実行] を選択します。次に、 [Use local input](ローカル入力を使用) または [Use live input](ライブ入力を使用) を選択します。ウィンドウの右側にジョブダイアグラムが表示されます。

出力と中間結果セットを表示する

すべてのジョブ出力が、Visual Studio Code ウィンドウの右下にある結果ウィンドウに表示されます。
クエリステップを選択してスクリプトに移動します。エディターの左側に、対応するスクリプトが自動的に表示されます。中間結果が、Visual Studio Code ウィンドウの右下にある結果ウィンドウに表示されます。

メトリックを表示する

このセクションでは、ダイアグラムの各部分で使用できるメトリックを確認します。

Visual Studio Code ウィンドウの右下で、 [結果] タブの横にある [メトリック] タブを選択します。
ドロップダウンから [ジョブ] を選択します。グラフノードの任意の空白領域を選択すると、ジョブレベルのメトリックに移動できます。このビューにはすべてのメトリックが含まれています。ジョブを実行すると、これらのメトリックが 10 秒ごとに更新されます。右側のメトリックを選択または選択解除することで、グラフに表示することができます。
入力メトリックを表示するには、ドロップダウンから入力データソースの名前を選択します。次のスクリーンショットの入力ソースの名前は "見積もり" になっています。入力メトリックの詳細については、「Azure Stream Analytics のジョブメトリック」を参照してください。
ジョブダイアグラムからクエリステップを選択するか、ドロップダウンからステップ名を選択すると、ステップレベルのメトリックが表示されます。使用可能なステップメトリックは、透かしの遅延のみです。
ダイアグラムまたはドロップダウンから出力を選択すると、出力関連のメトリックが表示されます。出力メトリックの詳細については、「Azure Stream Analytics のジョブメトリック」を参照してください。ライブ出力シンクはサポートされていません。