共用方式為


以 Visual Studio Code 在本機執行 U-SQL 及偵錯

重要

Azure Data Lake Analytics 於 2024 年 2 月 29 日淘汰。 使用此公告深入瞭解。

針對數據分析,您的組織可以使用 Azure Synapse AnalyticsMicrosoft Fabric

本文說明如何在本機開發電腦上執行 U-SQL 作業,以便加速早期的編碼階段,或以 Visual Studio Code 在本機對程式碼進行偵錯。 如需如何使用 Azure Data Lake Tools for Visual Studio Code 的指示,請參閱使用 Azure Data Lake Tools for Visual Studio Code

只有 Windows 安裝的 Azure Data Lake Tools for Visual Studio,才支援在本機執行 U-SQL 並在本機偵錯 U-SQL 的動作。 macOS 和 Linux 作業系統上的安裝不支援此功能。

設定 U-SQL 本機執行環境

  1. 按 Ctrl+Shift+P 開啟命令選擇區,然後輸入 ADL: Download Local Run Package 下載套件。

    下載 ADL LocalRun 相依性套件

  2. 從 [輸出] 窗格中顯示的路徑找出相依性套件,然後安裝 BuildTools 和 Win10SDK 10240。 以下是範例路徑:
    C:\Users\xxx\AppData\Roaming\LocalRunDependency

    找出相依性套件

    2.1 若要安裝 BuildTools,請在 LocalRunDependency 資料夾中選取 [visualcppbuildtools_full.exe],然後遵循精靈指示。

    安裝 BuildTools

    2.2 若要安裝 Win10SDK 10240,請在 LocalRunDependency/Win10SDK_10.0.10240_2 資料夾中選取 [sdksetup.exe],然後遵循精靈指示。

    安裝 Win10SDK 10240

  3. 設定環境變數。 將 SCOPE_CPP_SDK 環境變數設定為:
    C:\Users\XXX\AppData\Roaming\LocalRunDependency\CppSDK_3rdparty

啟動本機執行服務並將 U-SQL 作業提交給本機帳戶

如果您是初次使用,還沒設定 U-SQL 本機執行環境,請使用 ADL: Download Local Run Package 下載本機執行套件。

  1. 選取 Ctrl+Shift+P 來開啟命令選擇區,然後輸入 ADL: Start Local Run Service

  2. 選取 [接受] 來首次接受 Microsoft 軟體授權條款。

    接受 Microsoft 軟體授權條款

  3. 隨即會開啟 CMD 主控台。 如果您是初次使用者,就必須輸入 3,然後找出用於資料輸入和輸出的本機資料夾路徑。 如果您未成功定義反斜杠的路徑,請嘗試斜線。 其他選項則可以使用預設值。

    Data Lake Tools for Visual Studio Code 本機執行 CMD

  4. 選取 Ctrl+Shift+P 來開啟命令選擇區,輸入 ADL: Submit Job,然後選取 [Local] \(本機\) 以將作業提交給您的本機帳戶。

    Data Lake Tools for Visual Studio Code 選取本機

  5. 在提交作業後,您就可以檢視提交詳細資料。 若要檢視提交詳細資料,選取 [輸出] 視窗中的 [jobUrl]。 您也可以從 CMD 主控台檢視作業提交狀態。 如果您想要知道更多的作業詳細資料,請在 CMD 主控台中輸入 7

    Data Lake Tools for Visual Studio Code 本機執行輸出 Data Lake Tools for Visual Studio Code 本機執行 CMD 狀態

開始 U-SQL 作業的本機偵錯

初次使用者:

  1. 如果您還沒設定 U-SQL 本機執行環境,使用 ADL: Download Local Run Package 下載本機執行套件。
  2. 如訊息方塊中的建議安裝 .NET Core SDK 2.0 (如果尚未安裝)。   提醒安裝 Dotnet
  3. 如訊息方塊中的建議安裝 C# for Visual Studio Code (如果尚未安裝)。 選取 [安裝 ] 繼續,然後重新啟動 VS Code。

提醒安裝 C#

遵循下列步驟執行本機偵錯:

  1. 選取 Ctrl+Shift+P 來開啟命令選擇區,然後輸入 ADL: Start Local Run Service。 隨即會開啟 CMD 主控台。 請確定您已設定 DataRoot

  2. 在您的 C# 程式碼後置中設定中斷點。

  3. 回到指令碼編輯器,以滑鼠右鍵按一下並選取 ADL: Local Debug

    Data Lake Tools for Visual Studio Code 本機偵錯結果

下一步