在 Visual Studio Code 中本地运行 U-SQL 并进行本地调试

重要

Azure Data Lake Analytics于 2024 年 2 月 29 日停用。 通过此公告了解更多信息。

对于数据分析,组织可以使用 Azure Synapse AnalyticsMicrosoft Fabric

本文介绍如何在本地开发计算机上运行 U-SQL 作业,以让早期编码阶段提速,或在 Visual Studio Code 中本地调试代码。 有关针对 Visual Studio Code 的 Azure Data Lake 工具说明,请参阅使用针对 Visual Studio Code 的 Azure Data Lake 工具

仅针对 Visual Studio 的 Azure Data Lake 工具的 Windows 安装支持要本地运行 U-SQL 和本地调试 U-SQL 的操作。 在基于 macOS 和 Linux 的操作系统上安装不支持此功能。

设置 U-SQL 本地运行环境

  1. 按 Ctrl+Shift+P 打开命令面板,输入“ADL: 下载本地运行包”并下载包

    下载 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: 下载本地运行包”,来下载本地运行包

  1. 按 Ctrl+Shift+P 打开命令面板,并输入“ADL: 启动本地运行服务”

  2. 选择“接受”以接受首次安装时显示的 Microsoft 软件许可条款

    接受 Microsoft 软件许可条款

  3. 随即会打开 cmd 控制台。 对于首次使用的用户,需要输入 3,并找到数据输入和输出的本地文件夹路径。 如果使用反斜杠定义路径失败,请尝试正斜杠。 对于其他选项,可使用默认值。

    针对 Visual Studio Code 的 Data Lake 工具本地运行 cmd

  4. 按 Ctrl+Shift+P 打开命令面板,输入“ADL: 提交作业”并选择“本地”将作业提交到本地帐户

    针对 Visual Studio Code 的 Data Lake 工具选择“本地”

  5. 提交作业后,可以查看提交详细信息。 若要查看提交详细信息,请选择“输出”窗口中的“jobUrl” 。 也可以从 cmd 控制台查看作业提交状态。 如需了解更多作业详细信息,可在 cmd 控制台中输入 7

    针对 Visual Studio Code 的 Data Lake 工具本地运行输出 针对 Visual Studio Code 的 Data Lake 工具本地运行 cmd 状态

为 U-SQL 作业启动本地调试

对于初次使用的用户:

  1. 如果尚未设置 U-SQL 本地运行环境,请使用“ADL: 下载本地运行包”,来下载本地运行包
  2. 如果尚未安装 .NET Core SDK 2.0,请遵循消息框中的建议进行安装。   提醒安装 Dotnet
  3. 如果尚未安装针对 Visual Studio Code 的 C#,请遵循消息框中的建议进行安装。 选择“ 安装 ”以继续,然后重启 VS Code。

提醒安装 C#

若要执行本地调试,请按照以下步骤进行操作:

  1. 按 Ctrl+Shift+P 打开命令面板,并输入“ADL: 启动本地运行服务”。 随即会打开 cmd 控制台。 请确保已设置 DataRoot

  2. 在 C# 代码隐藏中设置断点。

  3. 返回到脚本编辑器,右键单击并选择“ADL:本地调试”

    针对 Visual Studio Code 的 Data Lake 工具本地调试结果

后续步骤