使用 Visual Studio Code 針對即時串流輸入在本機測試串流分析查詢

  • 發行項

在本機針對即時串流輸入測試串流分析查詢是確保查詢邏輯精確度和效率的重要步驟。 使用適用于 Visual Studio Code (VS Code) 的 Azure 串流分析 (ASA) 擴充功能，您有順暢地執行這項測試的必要工具。 本文會引導您完成設定環境、設定即時串流輸入，以及在本機執行查詢以進行徹底測試的步驟。

先決條件

  • 安裝 .NET 核心 SDK，並重新啟動 Visual Studio Code。
  • 請遵循本快速入門，使用 Visual Studio Code 來安裝和建立串流分析作業。

定義即時串流輸入

  1. 以滑鼠右鍵按一下串流分析專案中的 [輸入 ] 資料夾，然後選取 [ASA：新增輸入]。 透過下拉式功能表新增輸入的 VSCode 延伸模組螢幕擷取畫面。 或按 Ctrl+Shift+P 以開啟命令選擇區，然後輸入 ASA：新增輸入。 然後選取查詢腳本來處理輸入資料流程。 透過命令選擇區新增輸入的 VSCode 延伸模組螢幕擷取畫面。

  2. 從下拉式清單中選擇即時輸入來源類型， 從您的 Azure 訂 用帳戶選取並輸入輸入來源的名稱。 VSCode 延伸模組的螢幕擷取畫面，其中顯示事件中樞輸入設定的一系列步驟。

  3. 您會看到在 [輸入 ] 資料夾下建立的新 JSON 檔案。 開啟 檔案，然後 從您的訂用帳戶中選取 ，以協助您設定事件中樞輸入。 VSCode 延伸模組的螢幕擷取畫面，其中顯示輸入 json 檔案。

  4. 選取 [預覽資料 ] 以驗證即時輸入是否已順利設定。 VSCode 延伸模組預覽即時輸入資料的螢幕擷取畫面。

在本機執行查詢

開啟查詢檔案，選取 [在本機執行] 或功能表列上的 [播放] 按鈕，以開啟 [本機執行] 選項視窗以設定本機執行模式。

在查詢編輯器中選取 [在本機執行] 的 VSCode 延伸模組螢幕擷取畫面。

選擇 [使用即時輸入] 和 [本機輸出 ]，針對即時輸入串流在本機執行作業，並將輸出結果產生至本機資料夾。 然後選取 [執行 ] 以在本機開始執行作業。

VSCode 擴充功能選取本機執行的播放模式螢幕擷取畫面。

您可以看到 [本機測試 ] 視窗已開啟，每隔 3 秒重新整理一次。 輸出結果會儲存為 LocalRunOutputs 資料夾中的 JSON 格式。

顯示本機測試視窗的 VSCode 延伸模組螢幕擷取畫面。

指定本機測試的輸入分割區

若要避免從事件中樞擷取所有資料，您可以在本機測試期間指定事件中樞的特定分割區。

  1. 選取 [ 在本機執行 ] 以開啟 [本機執行] 選項視窗。
  2. 在 [選取輸入分割區] 區 段下，然後選擇 [ 自訂]。
  3. 輸入您要從 中擷取資料以進行本機測試的特定資料分割編號。

指定事件中樞分割的 VSCode 延伸模組螢幕擷取畫面。

藉由指定資料分割，您可以專注于測試查詢邏輯，而不必擔心大量資料。 這項功能可讓您更有效率且以目標方式測試串流分析作業。

將作業提交至 Azure

在本機完成查詢測試之後，您可以將串流分析專案提交至 Azure，並開始在雲端中執行作業。

  1. 選取 [ 提交至 Azure] 選項，或選取查詢檔案上的 [ 上傳 ] 按鈕。
  2. 在 [提交選項] 視窗中，您可以 更新 Azure 中的現有作業 ，或 為上傳建立新的作業 。
  3. 提供必要的詳細資料，包括部署的訂用帳戶、資源群組和區域。

將作業提交至 Azure 的 VSCode 延伸模組螢幕擷取畫面。

提交程式完成後，您可以在新的視窗中檢視您的雲端作業。 您可以從該處監視其效能，並視需要管理其設定。 您也可以按一下 [輸出] 面板中提供的連結，在瀏覽器中開啟作業。

顯示雲端檢視作業的 VSCode 延伸模組螢幕擷取畫面。

下一步