将 Git 文件夹与 Visual Studio Code 的 Databricks 扩展配合使用

Visual Studio Code 的 Databricks 扩展支持在 Azure Databricks 工作区中使用 Databricks Git 文件夹中的文件。 Databricks Git 文件夹是 0.3.15 版本之前的默认同步，但不再受到推荐。

默认情况下，Git 文件夹中的文件在所有 Azure Databricks 工作区中启用，但管理员可以使用 REST API 进行禁用。 如果无法访问此功能，请与工作区管理员联系。

设置存储库

如果你选择使用 Databricks Git 文件夹而不是 Azure Databricks 工作区中的工作区目录，请在打开扩展和代码项目并设置 Azure Databricks 配置文件后，使用 Visual Studio Code 的 Databricks 扩展在 Databricks Git 文件夹中创建新存储库并使用它，或者在 Databricks Git 文件夹中选择先前使用 Visual Studio Code 的 Databricks 扩展创建的、你要重用的现有存储库。

要使适用于 Visual Studio Code 的 Databricks 扩展能够使用 Azure Databricks 工作区内 Databricks Git 文件夹中的存储库，必须首先将该扩展的“同步：目标类型”设置设置为“存储库”，如下所示：

1. 打开扩展和代码项目并设置 Azure Databricks 配置文件后，在命令面板（“视图”>“命令面板”）中键入 Preferences: Open User Settings，然后单击“首选项: 打开用户设置”。
2. 在“用户”选项卡上展开“扩展”，然后单击“Databricks”。
3. 对于“同步: 目标类型”，请选择“存储库”。
4. 退出再重启 Visual Studio Code。

新建存储库

若要创建新存储库，请执行以下操作：

1. 在“配置”窗格中的“同步目标”旁边，单击齿轮（“配置同步目标”）图标。

   

2. 在“命令面板”中，单击“创建新的同步目标”。

3. 在 Databricks Git 文件夹中键入新存储库的名称，然后按 Enter。

   扩展会将字符 .ide 追加到存储库名称的末尾，然后将存储库的工作区路径添加到代码项目的 .databricks/project.json 文件，例如 "workspacePath": "/Workspace/Repos/someone@example.com/my-repo.ide"。

   注意

   如果远程存储库的名称与本地代码项目的名称不匹配，将显示警告图标和以下消息：远程同步目标名称与当前 Visual Studio Code 工作区名称不匹配。 如果你不要求名称匹配，则可以忽略此警告。

4. 设置存储库后，单击“同步目标”旁边的带箭头圆圈（开始同步）图标，以开始与该存储库同步。

   

重用现有存储库

如果你先前使用 Visual Studio Code 的 Databricks 扩展在 Databricks Git 文件夹中创建了一个存储库，并且想要在当前 Visual Studio Code 项目中重用该存储库，请执行以下操作：

1. 在“配置”窗格中的“同步目标”旁边，单击齿轮（“配置同步目标”）图标。

   

2. 在“命令面板”中，从列表中选择该存储库的名称。

   该扩展会将该存储库的工作区路径添加到代码项目的 .databricks/project.json 文件中，例如 "workspacePath": "/Workspace/Repos/someone@example.com/my-repo.ide"。

   注意

   如果远程存储库的名称与本地代码项目的名称不匹配，将显示警告图标和以下消息：远程同步目标名称与当前 Visual Studio Code 工作区名称不匹配。 如果你不要求名称匹配，则可以忽略此警告。

3. 设置存储库后，单击“同步目标”旁边的带箭头圆圈（开始同步）图标，以开始与该存储库同步。