注意
Databricks 建议在配置 Databricks IDE 扩展时使用工作区文件。
本文档已过时,将来可能不会更新。 本内容中提及的产品、服务或技术不再受支持。 这里提供的文档仅涵盖了为Databricks IDE扩展配置Git文件夹的具体内容。 有关完整文档,请参阅 适用于 Visual Studio Code 的 Databricks 扩展。
Databricks IDE 扩展支持在 Azure Databricks 工作区内处理 Databricks Git 文件夹中的文件。 在版本 0.3.15 之前,Databricks Git 文件夹是默认同步方式,但现在不再推荐使用。
默认情况下,Git 文件夹中的文件在所有 Azure Databricks 工作区中启用,但管理员可以使用 REST API 进行禁用。 如果无法访问此功能,请与工作区管理员联系。
重要
Databricks IDE 扩展只对它创建的仓库有效。 必须对 Azure Databricks 群集拥有执行权限才能运行代码,并且需要拥有在 Databricks Git 文件夹中创建存储库的权限。
设置存储库
如果你选择在 Azure Databricks 工作区中使用 Databricks Git 文件夹而不是工作区目录,那么在打开扩展和代码项目,并且已经设置好 Azure Databricks 配置配置文件后,使用 Databricks IDE 扩展在 Databricks Git 文件夹中创建一个新仓库并使用它,或者选择你创建的 Databricks Git 文件夹中的现有仓库之前用的是Databricks IDE扩展,现在想重新使用。
注意
Databricks IDE 扩展只对它创建的仓库有效。 不能使用工作区中的现有存储库。
要使 Databricks IDE 扩展能够在 Azure Databricks 工作区内的 Databricks Git 文件夹中使用仓库,首先必须将扩展的 Sync: Destination Type 设置设置为仓库,具体如下:
扩展和代码项目都已打开,并且已设置好 Azure Databricks 配置文件后,在命令面板(
视图 )中输入命令面板 ,然后单击 首选项: 打开用户设置 。在“用户”选项卡上展开“扩展插件”,然后单击“Databricks”。
在同步:目标类型中,选择代码仓库。
退出再重启 Visual Studio Code。
新建存储库
若要创建新存储库,请执行以下操作:
在“配置”窗格中的“同步目标”旁边,单击齿轮(“配置同步目标”)图标。
在“命令面板”中,单击“创建新的同步目标”。
在 Databricks Git 文件夹中键入新存储库的名称,然后按 Enter。
扩展会将字符
.ide追加到存储库名称的末尾,然后将存储库的工作区路径添加到代码项目的.databricks/project.json文件,例如"workspacePath": "/Workspace/Repos/someone@example.com/my-repo.ide"。注意
如果远程存储库的名称与本地代码项目的名称不匹配,将显示警告图标和以下消息:远程同步目标名称与当前 Visual Studio Code 工作区名称不匹配。 如果你不要求名称匹配,则可以忽略此警告。
设置存储库后,单击“同步目标”旁边的带箭头圆圈(开始同步)图标,以开始与该存储库同步。
重要
Databricks IDE 扩展仅能实现从本地 Visual Studio Code 项目到远程 Azure Databricks 工作区相关仓库的文件变更的单向自动同步。 这些远程存储库文件是为了临时使用而设计的。 不要从远程存储库内部对这些文件启动更改,因为这些更改不会同步回本地项目。
重用现有存储库
如果你在Databricks Git文件夹里已有之前用Databricks IDE扩展创建的仓库,并且想在当前的Visual Studio Code项目中复用,那么请这样做:
在“配置”窗格中的“同步目标”旁边,单击齿轮(“配置同步目标”)图标。
在“命令面板”中,从列表中选择该存储库的名称。
该扩展会将该存储库的工作区路径添加到代码项目的
.databricks/project.json文件中,例如"workspacePath": "/Workspace/Repos/someone@example.com/my-repo.ide"。注意
如果远程存储库的名称与本地代码项目的名称不匹配,将显示警告图标和以下消息:远程同步目标名称与当前 Visual Studio Code 工作区名称不匹配。 如果你不要求名称匹配,则可以忽略此警告。
设置存储库后,单击“同步目标”旁边的带箭头圆圈(开始同步)图标,以开始与该存储库同步。
重要
Databricks IDE 扩展仅能实现从本地 Visual Studio Code 项目到远程 Azure Databricks 工作区相关仓库的文件变更的单向自动同步。 这些远程存储库文件是为了临时使用而设计的。 不要从远程存储库内部对这些文件启动更改,因为这些更改不会同步回本地项目。