使用 C Sharp 從 Azure 時間序列深入解析 Gen2 環境查詢資料

注意

時間序列深入解析 （TSI） 服務在 2025 年 3 月之後將不再受到支援。 請考慮儘快將現有的 TSI 環境移轉至替代解決方案。 如需淘汰和移轉的詳細資訊，請流覽我們的 檔 。

此 C# 範例示範如何在 Azure 時間序列深入解析 Gen2 環境中查詢 Gen2 資料存取 API 中的資料 。

提示

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

摘要

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

• 支援從 Azure AutoRest 自動產生 SDK。

• 如何使用 Microsoft.IdentityModel.Clients.ActiveDirectory 透過 Microsoft Entra ID 取得存取權杖。

• 如何在後續資料存取 API 要求的標頭中 Authorization 傳遞該取得的存取權杖。

• 此範例提供主控台介面，示範如何對下列專案提出 HTTP 要求：

  • Gen2 環境 API
    • 取得環境可用性 API 和 取得事件架構 API
  • Gen2 查詢 API
    • 取得事件 API 、 取得系列 API 和 取得匯總數列 API
  • 時間序列模型 API
    • 取得階層 API 和 階層 Batch API
    • 取得類型 API 和 類型 Batch API
    • 取得實例 API 和 實例 Batch API

• 進階 搜尋 和 TSX 功能。

先決條件和安裝程式

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

1. 布建 Gen2 Azure 時間序列深入解析 環境。
2. 如驗證和授權 中所述 ，為 Microsoft Entra ID 設定您的Azure 時間序列深入解析環境。
3. 執行 Readme.md 中指定的 GenerateCode.bat ，以產生 Azure 時間序列深入解析 Gen2 用戶端相依性。
4. 開啟方案， TSIPreviewDataPlaneclient.sln 並將 設定 DataPlaneClientSampleApp 為 Visual Studio 中的預設專案。
5. 使用 下列步驟 安裝必要的專案相依性，並將範例編譯為可執行檔 .exe 。
6. .exe按兩下檔案以執行檔案。

專案相依性

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

• Visual Studio 2019 - 版本 16.4.2+

範例程式碼有數個必要的相依性，可在 packages.config 檔案中 檢視。

選取 [建 > 置方案 ] 選項，以下載 Visual Studio 2019 中的套件。

或者，使用 NuGet 2.12+ 新增每個套件。 例如：

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

C# 範例程式碼

請參閱 Azure 時間序列深入解析 存放庫，以存取 C# 範例程式碼。

注意

• 您可以執行程式碼範例，而不需改變預設環境變數。
• 程式碼範例會編譯至 .NET 可執行主控台應用程式。

下一步

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

• 瞭解如何使用用戶端 SDK 將 JavaScript 應用程式連線到Azure 時間序列深入解析。