在 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 工具

只有在 Windows 上安装的 Visual Studio 的 Azure Data Lake 工具支持在本地运行 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 作业提交到本地帐户

对于第一次用户,请使用 ADL:下载本地运行包 下载本地运行包(如果尚未 设置 U-SQL 本地运行环境)。

  1. 选择 Ctrl+Shift+P 打开命令面板,然后输入 ADL:启动本地运行服务

  2. 选择 “接受”以首次接受Microsoft软件许可条款。

    接受Microsoft软件许可条款

  3. 此时会打开 cmd 控制台。 对于第一次用户,需要输入 3,然后找到数据输入和输出的本地文件夹路径。 如果使用反斜杠定义路径不成功,请尝试使用正斜杠。 对于其他选项,可以使用默认值。

    用于 Visual Studio Code 的 Data Lake 工具本地运行命令行

  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. 使用 ADL:下载本地运行包 下载本地运行包(如果尚未 设置 U-SQL 本地运行环境)。
  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 工具本地调试结果

后续步骤