使用 Visual Studio Code 在本地測試 Stream Analytics 查詢,並提供範例資料

使用 Azure 串流分析 工具,針對 Visual Studio Code,在本地測試你的 Stream Analytics 工作並取得範例資料。 在本地測試可以讓你在執行 Azure 工作前快速驗證查詢邏輯。 Visual Studio Code 會將輸出結果以 JSON 檔案儲存在專案的 LocalRunOutputs 資料夾中。

先決條件

準備樣本資料

先準備範例輸入資料檔。 如果你機器上已經有範例資料檔,可以跳過這個步驟。

若要根據即時串流來源而非已儲存的範例資料來驗證您的查詢,請參閱 使用 Visual Studio Code 針對即時串流輸入在本機測試 Stream Analytics 查詢

  1. 在輸入設定檔中,從最上方一行選擇 預覽資料。 Visual Studio Code 會從 IoT 中樞 取得一些輸入資料,並在預覽視窗中顯示。

  2. 資料出現後,選擇 另存為(Save as )將資料儲存到本地檔案。

Visual Studio Code 輸入設定檔的截圖,選取預覽資料以擷取即時輸入。

定義一個局部輸入

在你的串流分析專案中定義一個本地輸入,讓你的查詢能從範例資料檔讀取,而非即時來源。 請依照以下步驟新增並設定本地輸入:

  1. 在你的 Stream Analytics 專案中的 Inputs 資料夾中選擇 input.json 。 然後從頂行選擇 新增本地輸入

    Visual Studio Code 中 Stream Analytics 專案的截圖,從頂行選取「新增本地輸入」。

    你也可以用 Ctrl+Shift+P 開啟指令面板,輸入 ASA:新增輸入

    Visual Studio Code 指令面板的截圖,輸入了 ASA: Add Input 指令。

  2. 選擇 本地輸入

    Visual Studio Code 截圖顯示 Stream Analytics 輸入中選擇了本地輸入選項。

  3. 選擇 + 新的本地輸入

    Visual Studio Code 截圖顯示 Stream Analytics 輸入已選中新的本地輸入選項。

  4. 輸入你查詢時用的輸入別名。

    Visual Studio Code 的螢幕擷取畫面,顯示新串流分析本機輸入的輸入別名項目。

  5. 在新產生的 LocalInput_Input.json 檔案中,輸入你本地資料檔案的路徑。

    Visual Studio Code LocalInput_Input.json 檔案截圖,並輸入了本地資料檔案路徑。

  6. 選擇 預覽資料 以預覽輸入資料。 Visual Studio Code 會自動偵測資料的序列化類型(JSON 或 CSV)。 使用選取器以 表格原始格式 檢視您的資料。 以下表格為表格 格式資料的範例:

    本地輸入資料的截圖,以 Visual Studio Code 表格格式預覽。

    以下表格為 原始格式資料的範例:

    在 Visual Studio Code 中以 Raw 格式預覽的本機輸入資料螢幕擷圖。

在本地執行查詢

先用本地輸入執行查詢,驗證查詢邏輯,再在 Azure 執行工作。

  1. 回到查詢編輯器,選擇 本地執行。 然後從下拉選單選擇 「使用本地輸入 」。

    Visual Studio Code 中 Stream Analytics 查詢編輯器的截圖,當地選擇了 Run。

    Visual Studio Code 的截圖顯示從下拉選單中選擇使用本地輸入選項。

  2. 在正確的視窗中檢視結果。 選擇 執行 以再次測試,或選擇在資料夾 中開啟 ,在檔案總管中查看結果檔案並用其他工具開啟。 結果檔案僅提供 JSON 格式。

    右側 Visual Studio Code 視窗中顯示的本地執行結果截圖。