什么是 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 扩展的先决条件:
- 从 OpenJDK8 网站安装 Java 开发工具包 (JDK)。 确保使用 JDK 链接而不是 JRE。
- 安装 Conda。
- 安装适用于 VS Code 的 Jupyter 扩展
安装所需的软件后,必须更新操作系统属性。
Windows
将 JAVA_HOME 添加到环境变量,并将其指向安装 java 1.8 的目录。 例如,如果将 JDK 安装在路径
C:\Program Files\Java\jdk-1.8
,请将 JAVA_HOME 变量的值设置为该路径。将 %JAVA_HOME%/bin 以及 Conda 安装的 condabin 子文件夹添加到系统路径目录。 condabin 文件夹可以放在安装文件夹中,并采用格式
\miniconda3\condsbin
。 打开环境变量,将 %JAVA_HOME%/bin 和 condabin 路径添加到 Path 变量。
macOS
在终端中运行 conda.sh:
打开终端窗口,将目录更改为安装 conda 的文件夹,然后更改为子目录 etc/profile.d。 子目录应包含名为 conda.sh 的文件。
执行
source conda.sh
。在同一终端窗口中,运行
sudo conda init
。键入
Java --version
。 版本应为 Java 1.8。
安装扩展并准备环境
在 VS Code 扩展市场中搜索 Synapse VS Code 并安装扩展。
扩展安装完成后,重启 VS Code。 VS Code 活动栏中列出了扩展的图标。
本地工作目录
若要编辑笔记本,必须具有笔记本内容的本地副本。 扩展的本地工作目录充当所有已下载笔记本(甚至是来自不同工作区的笔记本)的本地根文件夹。 通过调用命令 Synapse:Set Local Work Folder
,可以将文件夹指定为扩展的本地工作目录。
若要验证设置,请打开扩展设置,并在其中检查详细信息:
登录和注销帐户
在 VS Code 命令面板中,输入
Synapse:Sign in
命令以登录到扩展。 此时会显示单独的浏览器登录页。输入用户名和密码。
成功登录后,你的用户名将显示在 VS Code 状态栏中,以指示你已登录。
若要退出登录扩展,请输入命令
Synapse: Sign off
。
选择要使用的工作区
若要选择 Fabric 工作区,必须创建工作区。 如果没有工作区,可以使用 Fabric 门户创建一个。 有关详细信息,请参阅创建工作区。
拥有工作区后,通过选择“选择工作区”选项来选择它。 此时会显示一个列表,其中包含你有权访问的所有工作区;从列表中选择所需的一个。
当前限制
- 桌面模式下的扩展尚不支持 Microsoft Spark 实用工具
- 不支持 Shell 命令以“!”开头。
相关内容
在本概述中,你将基本了解如何安装和设置 Synapse VS Code 扩展。 接下来的文章介绍如何在 VS Code 中本地开发笔记本和 Spark 作业定义。
- 若要开始使用笔记本,请参阅在 Visual Studio Code 中创建和管理 Microsoft Fabric 笔记本。
- 若要开始使用 Spark 作业定义,请参阅在 Visual Studio Code 中创建和管理 Apache Spark 作业定义。