使用 ASA 工具在 Visual Studio Code 中本地測試串流分析作業的概觀

您可以使用適用於 Visual Studio Code 的 Azure 串流分析工具 (ASA 工具),在本地測試串流分析作業。 說到位置時,需要考慮三個層面:作業執行內容 (本地電腦或 Azure 雲端服務)、輸入來源和輸出接收。

在本地執行中,查詢會在本地電腦上執行。 針對輸入,可以從本地檔案或即時來源內嵌資料。 輸出結果會以檔案的形式傳送至本地資料夾,或傳送到即時接收。

本地執行的輸入考慮

在 VS Code 中,您可以定義即時和本地輸入

  • 即時輸入是指向支援的輸入執行個體的設定檔 (串流和參考資料)。 其也會提供預覽和樣本資料給 JSON 檔案。
  • 本地輸入是指向支援格式 (JSON/CSV/AVRO) 的本地檔案設定檔。 這些檔案可以從即時輸入取樣,或以任何其他方式產生。

建立本地輸入時,其可以與現有即時輸入保持一致。 在此情況下,其會在本地輸入執行期間模擬即時輸入。 其設定檔會以即時輸入命名,前面加上 Local_。 此本地輸入所使用的資料檔案不會遵循即時輸入中定義的格式和序列化格式。 其格式是獨立的。

本地執行的輸出考慮

執行作業至本地輸出時,輸出結果會傳送至名為 LocalRunOutputs 專案中的資料夾。 在此模式中,不需要定義輸出。 唯一的限制式是查詢中的每個 INTO 陳述式都指向唯一的輸出名稱。 執行至本地輸出之後,將會為每個唯一的輸出名稱建立 JSON 檔案。

本地執行模式

在 VS Code 中由 ASA 工具在本地執行作業支援的三種模式:

  • 本地執行搭配本地輸入和本地輸出:最適合使用 npm 套件免費進行離線開發、單元測試...
  • 使用即時輸入和本地輸出的本地執行:最適合用於輸入設定、取消序列化和分割偵錯...
  • 使用即時輸入和即時輸出的本地執行:最適合用於輸出設定、序列化和轉換錯誤偵錯...

每個模式都支援不同的輸入和輸出設定:

執行 [模式] 輸入 輸出
VS Code 本地輸入至本地輸出 JSON/CSV/AVRO 檔案 JSON 檔案 (即使存在,仍不會使用對應即時輸出格式)
VS Code 即時輸入至本地輸出 所有輸入配接器 JSON 檔案 (即使存在,仍不會使用對應即時輸出格式)
VS Code 即時輸入至即時輸出 所有輸入配接器 事件中樞、儲存體帳戶、Azure SQL
Azure N/A 所有輸入配接器 所有輸出配接器

在本地執行作業時,Azure 串流分析服務不會產生任何成本。 不需要在 Azure 中建立串流分析資源。

開始使用

使用此快速入門了解如何使用 Visual Studio Code 和 ASA 工具建立串流分析作業。

然後,如需本地執行的逐步教學課程,請參閱:

下一步