C# を使用して Azure Time Series Insights Gen1 環境からデータのクエリを実行する
Note
Time Series Insights サービスは、2024 年 7 月 7 日に廃止されます。 できるだけ早く既存の環境を代替ソリューションに移行することを検討してください。 サポートの終了と移行の詳細については、こちらのドキュメントを参照してください。
注意事項
これは Gen1 の記事です。
この C# サンプルでは、Gen1 Query API を使用して Azure Time Series Insights Gen1 環境からデータのクエリを実行する方法について説明します。
ヒント
https://github.com/Azure-Samples/Azure-Time-Series-Insights で Gen1 C# コード サンプルを表示します。
まとめ
次のサンプル コードでは、以下の機能が示されます。
Microsoft.IdentityModel.Clients.ActiveDirectory を使用して、Microsoft Entra ID を通じてアクセス トークンを取得する方法。
取得したアクセス ークンを後続のクエリ API 要求の
Authorization
ヘッダーで渡す方法。このサンプルでは、それぞれの Gen1 Query API を呼び出して、以下に対する HTTP 要求がどのように行われるかを示します。
- Get Environments API (ユーザーがアクセスできる環境を返します)
- Get Environment Availability API
- Get Environment Metadata API (環境メタデータを取得します)
- Get Environments Events API
- Get Environment Aggregates API
以下に対するメッセージ処理のために、WSS を使用して Gen1 Query API と対話する方法。
前提条件および設定
サンプル コードをコンパイルして実行する前に、次の手順を実行します。
- Gen1 Azure Time Series Insights 環境をプロビジョニングします。
- 「認証と承認」にある説明に基づき、Microsoft Entra ID で Azure Time Series Insights 環境を設定します。
- 必要なプロジェクト依存関係をインストールします。
- 各 #DUMMY# を該当する環境識別子に置換し、下のサンプル コードを編集します。
- Visual Studio 内でコードを実行します。
プロジェクトの依存関係
最新バージョンの Visual Studio を使用することをお勧めします。
- Visual Studio 2019 - バージョン 16.4.2+
サンプル コードには必須の依存関係が 2 つあります。
- Microsoft.IdentityModel.Clients.ActiveDirectory - 3.13.9 パッケージ。
- Newtonsoft.Json - 9.0.1 パッケージ。
[ビルド]>[ソリューションのビルド] オプションを順に選択して、Visual Studio 2019 にパッケージをダウンロードします。
または、NuGet 2.12+ を使用してパッケージを追加します。
dotnet add package Newtonsoft.Json --version 9.0.1
dotnet add package Microsoft.IdentityModel.Clients.ActiveDirectory --version 3.13.9
C# サンプル コード
Azure Time Series Insights リポジトリを参照し、C# サンプル コードにアクセスします。
次のステップ
クエリの詳細については、クエリ API リファレンスを参照してください。
Time Series Insights に クライアント SDK を使用して JavaScript アプリを接続する方法について確認します。 Azure-Samples/Azure-Time-Series-Insights/gen1-sample/csharp-tsi-gen1-sample/Program.cs