使用 C Sharp 從 Azure 時間序列深入解析 Gen1 環境查詢數據

注意

時間序列深入解析服務將於 2024 年 7 月 7 日淘汰。 請考慮儘快將現有的環境移轉至替代解決方案。 如需淘汰和移轉的詳細資訊，請造訪我們的文件。

警告

這是 Gen1 文章。

此 C# 範例示範如何使用 Gen1 查詢 API 從 Azure 時間序列深入解析 Gen1 環境查詢數據。

提示

在檢視 Gen1 C# 程式代碼範例 https://github.com/Azure-Samples/Azure-Time-Series-Insights。

摘要

下列範例程式代碼示範下列功能：

• 如何使用 Microsoft.IdentityModel.Clients.ActiveDirectory，透過 Microsoft Entra ID 取得存取令牌。

• 如何在後續查詢 API 要求的標頭中 Authorization 傳遞該取得的存取令牌。

• 此範例會呼叫每個 Gen1 查詢 API，示範如何對 進行 HTTP 要求：

  • 取得環境 API 以傳回使用者可存取的環境
  • 取得環境可用性 API
  • 取得環境元數據 API 以擷取環境元數據
  • 取得環境事件 API
  • 取得環境匯總 API

• 如何使用 WSS 與 Gen1 查詢 API 互動，以傳送下列訊息：

  • 取得串流處理的環境事件 API
  • 取得環境匯總串流 API

先決條件和安裝程式

在編譯和執行範例程序代碼之前，請先完成下列步驟：

1. 布建 Gen1 Azure 時間序列深入解析 環境。
2. 如驗證和授權中所述，為 Microsoft Entra ID 設定您的 Azure 時間序列深入解析 環境。
3. 安裝必要的專案相依性。
4. 將每個 #DUMMY# 取代為適當的環境識別碼，以編輯下列範例程式代碼。
5. 在 Visual Studio 內執行程式代碼。

專案相依性

建議您使用最新版的 Visual Studio：

• Visual Studio 2019 - 版本 16.4.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 時間序列深入解析] 存放庫，以存取 C# 範例程序代碼。

下一步

• 若要深入了解查詢，請閱讀 查詢 API 參考。

• 瞭解如何使用用戶端 SDK 將 JavaScript 應用程式連線到時間序列深入解析。 Azure-Samples/Azure-Time-Series-Insights/gen1-sample/csharp-tsi-gen1-sample/Program.cs