C# を使用して Azure Time Series Insights Gen2 環境からデータを照会する

Note

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

この C# サンプルでは、Azure Time Series Insights Gen2 環境にあるGen2 のデータアクセス API からデータを照会する方法を示しています。

ヒント

まとめ

次のサンプルコードでは、以下の機能が示されます。

Azure AutoRest からの SDK 自動生成のサポート。
Microsoft.IdentityModel.Clients.ActiveDirectory を使用して、Microsoft Entra ID を通じてアクセストークンを取得する方法。
取得したアクセストークンを後続のデータアクセス API 要求の Authorization ヘッダー内で渡す方法。
サンプルでは、以下に対して HTTP 要求が行われる方法を示すコンソールインターフェイスを提供しています。
- Gen2 Environment API
  - Get Environments Availability API および Get Event Schema API
- Gen2 Query API
  - Get Events API、Get Series API、および Get Aggregate Series API
- タイムシリーズモデル API
  - Get Hierarchies API と Hierarchies Batch API
  - Get Types API と Types Batch API
  - Get Instances API と Instances Batch API
高度な検索および TSX の機能。

サンプルコードをコンパイルして実行する前に、次の手順を実行します。

Gen2 Azure Time Series Insights 環境をプロビジョニングします。
「認証と承認」にある説明に基づき、Microsoft Entra ID で Azure Time Series Insights 環境を設定します。
Readme.md に示されているように GenerateCode.bat を実行して、Azure Time Series Insights Gen2 クライアントの依存関係を生成します。
Visual Studio 上で TSIPreviewDataPlaneclient.sln ソリューションを開き、DataPlaneClientSampleApp を既定のプロジェクトとして設定します。
以下に示された手順を使用して必要なプロジェクトの依存関係をインストールし、サンプルを実行可能な .exe ファイルにコンパイルします。
.exe ファイルをダブルクリックして、実行します。

最新バージョンの Visual Studio を使用することをお勧めします。

サンプルコードには、packages.config ファイル内で確認できる必須の依存関係がいくつかあります。

[ビルド]>[ソリューションのビルド] オプションを順に選択して、Visual Studio 2019 にパッケージをダウンロードします。

または、NuGet 2.12+ を使用して、各パッケージを追加します。次に例を示します。

dotnet add package Microsoft.IdentityModel.Clients.ActiveDirectory --version 4.5.1

Azure Time Series Insights リポジトリを参照し、C# サンプルコードにアクセスします。

Note