通过

什么是 Synapse Visual Studio Code 扩展？

  • 项目

Synapse Visual Studio Code 扩展支持专业开发人员体验，可用于探索 Microsoft Fabric 湖屋，以及创作 Fabric 笔记本和 Spark 作业定义。 详细了解该扩展，包括如何开始使用的必要先决条件。

Visual Studio （VS） Code 是最受欢迎的轻型源代码编辑器之一;它在桌面上运行，适用于 Windows、macOS 和 Linux。 通过安装 Synapse VS Code 扩展，可以在 VS Code 本地创作、运行和调试笔记本和 Spark 作业定义。 还可以将代码发布到 Fabric 工作区中的远程 Spark 计算，以便运行或调试。 该扩展还允许在 VS Code 中浏览 Lakehouse 数据，包括表和原始文件。

先决条件

Synapse VS Code 扩展的先决条件：

  • 从 OpenJDK8 网站安装 Java 开发工具包（JDK）。 确保使用 JDK 链接而不是 JRE。
  • 安装 Conda。
  • 为 VS Code 安装 Jupyter 扩展

安装所需的软件后，必须更新操作系统属性。

Windows

  1. 将 JAVA_HOME 添加到环境变量，并将其指向安装 java 1.8 的目录。 例如，如果在此路径上安装 JDK C:\Program Files\Java\jdk-1.8，请将 JAVA_HOME 变量值设置为该路径。

  2. 将 Conda 安装的 %JAVA_HOME%/bin 和 condabin 子文件夹添加到系统路径目录。 condabin 文件夹可以位于你安装的文件夹中，并且采用此格式 \miniconda3\condsbin。 打开环境变量并将 %JAVA_HOME%/bin 和 condabin 路径添加到 Path 变量。

macOS

在终端中运行 conda.sh：

  1. 打开终端窗口，将目录更改为安装了 conda 的文件夹，然后更改为子目录 etc/profile.d。 子目录应包含名为 conda.sh的文件。

  2. 执行 source conda.sh。

  3. 在同一终端窗口中，运行 sudo conda init。

  4. 键入 Java --version。 版本应为 Java 1.8。

安装扩展并准备环境

  1. 在 VS Code 扩展市场中搜索 Synapse VS Code 并安装该扩展。

  2. 扩展安装完成后，重启 VS Code。 扩展的图标列在 VS Code 活动栏上。

本地工作目录

若要编辑笔记本，必须具有笔记本内容的本地副本。 扩展的本地工作目录充当所有下载的笔记本的本地根文件夹，甚至是来自不同工作区的笔记本。 通过调用命令 Synapse:Set Local Work Folder，可以将文件夹指定为扩展的本地工作目录。

若要验证设置，请打开扩展设置，并检查其中的详细信息：

“设置”屏幕的屏幕截图，其中显示了所选的本地工作目录。

登录和注销帐户

  1. 在 VS Code 命令面板中，输入 Synapse:Sign in 命令以登录到扩展。 此时会显示单独的浏览器登录页。

  2. 输入用户名和密码。

  3. 成功登录后，用户名将显示在 VS Code 状态栏中，指示你已登录。

    VS Code 状态栏的屏幕截图，其中显示了查找登录状态的位置。

  4. 若要注销扩展，请输入命令 Synapse: Sign off。

选择要使用的工作区

若要选择 Fabric 工作区，必须创建一个工作区。 如果没有，可以在 Fabric 门户中创建一个。 有关详细信息，请参阅 创建工作区。

有了工作区后，通过选择“选择工作区”选项来选择它。 将显示你有权访问的所有工作区的列表;从列表中选择所需项。

VS Code Explorer 的屏幕截图，其中显示了“选择工作区”选项的位置。

当前限制

相关内容

在本概述中，你将基本了解如何安装和设置 Synapse VS Code 扩展。 接下来的文章介绍如何在 VS Code 中在本地开发笔记本和 Spark 作业定义。

  • 若要开始使用笔记本，请参阅 在 Visual Studio Code中创建和管理 Microsoft Fabric 笔记本。
  • 若要开始使用 Spark 作业定义，请参阅 在 Visual Studio Code中创建和管理 Apache Spark 作业定义。