什么是 Synapse Visual Studio Code 扩展?

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

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

先决条件

Synapse VS Code 扩展的先决条件:

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

Windows

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

  2. %JAVA_HOME%/bin 以及 Conda 安装的 condabin 子文件夹添加到系统路径目录。 condabin 文件夹可以放在安装文件夹中,并采用格式 \miniconda3\condsbin。 打开环境变量,将 %JAVA_HOME%/bincondabin 路径添加到 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 状态栏中,以指示你已登录。

    状态栏截图,显示登录状态的位置。

  4. 若要退出登录扩展,请输入命令 Synapse: Sign off

选择要使用的工作区

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

拥有工作区后,通过选择“选择工作区”选项来选择它。 此时会显示一个列表,其中包含你有权访问的所有工作区;从列表中选择所需的一个。

VS Code 资源管理器的屏幕截图,显示了“选择工作区”选项的位置。

当前限制

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