注意
本文适用于早期版本的Databricks IDE扩展。 关于Databricks IDE扩展(版本2及以上)的工作区同步信息,请参见 “与Databricks同步您的工作区文件夹”。
本文档已过时,将来可能不会更新。 本内容中提及的产品、服务或技术不再受支持。
本文介绍如何为 Databricks IDE 扩展选择 Azure Databricks 工作区目录。 参见 Databricks IDE扩展
以下信息假设你已经设置了Databricks IDE扩展以实现Azure Databricks工作区的身份验证。 参见 Databricks IDE 扩展的授权设置。
注意
Databricks IDE 扩展仅对其创建的工作区目录工作。 不能在工作区中使用现有工作区目录,除非它是由扩展创建的。
要使用带有 Databricks IDE 扩展的工作区目录,必须使用该扩展的 0.3.5 版本或更高版本,并且你的 Azure Databricks 集群必须安装 Databricks Runtime 11.3 LTS 或更高版本。
从扩展版本 0.3.15 开始,工作区目录是默认设置。 但是,如果将扩展设置为使用 Databricks Git 文件夹而不是工作区目录,可以将扩展重新设置为使用工作区目录,如下所示:
- 在打开扩展和代码项目后,且已设置好 Azure Databricks 配置文件,在命令面板(
命令面板 )中键入 ,然后单击 首选项:打开用户设置 。 - 在
选项卡上,展开 ,然后单击 。 - 对于“同步: 目标类型”,请选择“工作区”。
- 退出并重启Visual Studio Code。
请注意,将设置从使用 Databricks Git 文件夹更改为使用工作区目录后,可能需要手动地将代码重新同步到工作区。 为此,请在下一过程中创建新的工作区目录后,单击“同步目标”旁边的带箭头圆圈(“开始同步”)图标。
打开扩展和代码项目后,创建要使用的新Azure Databricks工作区目录,或选择之前使用扩展创建的现有工作区目录。
创建新的工作区目录
若要创建新的工作区目录,请执行以下操作:
在“配置”窗格中的“同步目标”旁边,单击齿轮(“配置同步目标”)图标。
在“命令面板”中,单击“创建新的同步目标”。
键入新工作区目录的名称,然后按 Enter。
该扩展在工作区中创建具有指定目录名称
/Users/<your-username>/.ide的目录,然后将工作区目录的路径添加到代码项目.databricks/project.json的文件,例如"workspacePath": "/Users/<your-username>/.ide/<your-directory-name>"。注意
如果远程工作区目录的名称与本地代码项目的名称不匹配,将显示一个警告图标,并显示以下消息:远程同步目标名称与当前Visual Studio Code工作区名称不匹配。 如果你不要求名称匹配,则可以忽略此警告。
设置工作区目录后,通过单击“同步目标”旁边的带箭头圆圈(开始同步)图标开始与工作区目录同步。
重要
Databricks IDE 扩展仅能单向自动同步本地 Visual Studio Code 项目的文件变更到远程 Azure Databricks 工作区中的相关工作区目录。 此远程工作区目录中的文件是临时文件。 不要从远程工作区内部对这些文件启动更改,因为这些更改不会同步回本地项目。
重用现有的工作区目录
如果你有一个之前用 Databricks IDE 扩展创建的现有工作区目录,想在当前的 Visual Studio Code 项目中复用,那么请这样做:
在“配置”窗格中的“同步目标”旁边,单击齿轮(“配置同步目标”)图标。
在 命令面板中,从列表中选择工作区目录的名称。
该扩展将工作区目录的路径添加到代码项目 .databricks/project.json 的文件,例如 "workspacePath": "/Users/<your-username>/.ide/<your-directory-name>"。
注意
如果远程工作区目录的名称与本地代码项目的名称不匹配,将显示一个警告图标,并显示以下消息:远程同步目标名称与当前Visual Studio Code工作区名称不匹配。 如果你不要求名称匹配,则可以忽略此警告。
设置工作区目录后,通过单击“同步目标”旁边的带箭头圆圈(开始同步)图标开始与工作区目录同步。
重要
Databricks IDE 扩展仅能单向自动同步本地 Visual Studio Code 项目的文件变更到远程 Azure Databricks 工作区中的相关工作区目录。 此远程工作区目录中的文件是临时文件。 不要从远程工作区内部对这些文件启动更改,因为这些更改不会同步回本地项目。