通过

诊断和解决 Databricks Git 文件夹中的错误

本页提供有关 Databricks Git 文件夹的常见错误消息和故障排除问题的指南。

Invalid credentials

请尝试以下做法：

  • 确认 Git 集成设置（“设置”“关联帐户”）是否正确>。 必须输入 Git 提供程序的用户名和令牌。

  • 确认在“设置>”中选择了正确的 Git 提供程序。

  • 验证个人访问令牌或应用密码是否具有正确的存储库访问权限。

  • 如果您的 Git 提供商已启用单点登录 (SSO)，请为单点登录授权您的令牌。

  • 使用命令行 Git 测试令牌。 替换尖括号中的文本字符串：

    git clone https://<username>:<personal-access-token>@github.com/<org>/<repo-name>.git

Secure connection...SSL problems

如果 Azure Databricks 无法访问 Git 服务器，则会发生此错误。 若要访问专用 Git 服务器，请联系 Azure Databricks 帐户团队。

<link>: Secure connection to <link> could not be established because of SSL problems

Microsoft Entra ID 凭据错误

Encountered an error with your :re[ms-entra-id] credentials. Try logging out of :re[ms-entra-id] and logging back in.

如果团队最近开始使用多重身份验证（MFA）策略，则可能会出现此错误。 若要解决此错误，请转到 portal.azure.cn 并注销 Microsoft Entra ID。 重新登录时，应会看到使用 MFA 的提示。

如果不起作用，请在再次登录之前尝试注销所有 Azure 服务。

超时错误

克隆大型存储库或签出大型分支等操作可能导致超时错误。 但是，该操作可能会在后台完成。 如果工作区负载过大，请稍后重试。

若要使用大型存储库，请尝试稀疏签出。

404 错误

如果在打开非笔记本文件时出现 404 错误，请等待几分钟，然后重试。 系统启用工作区时和 Web 应用选取配置之间存在短暂延迟。

分离的头状态

如果符合以下情况，Databricks Git 文件夹可以进入分离的头状态：

  • 有人删除远程分支。 Databricks 尝试通过将未提交的本地更改应用到默认分支来恢复未提交的本地更改。 如果发生冲突的更改，Databricks 会将这些更改应用于默认分支（分离头）的快照。
  • 用户或服务主体使用 update repo API 检出标签。

若要从此状态进行恢复：

  1. 单击创建分支以从当前提交创建新的分支，或选择分支以检出现有分支。
  2. 提交并推送以保留更改。 若要放弃更改，请单击“更改Kebab menu icon.Kebab menu icon.”下的。

解决笔记本名称冲突

创建存储库或拉取请求时，具有相同文件名或类似文件名的笔记本电脑可能会发生错误，例如 Cannot perform Git operation due to conflicting names 或 A folder cannot contain a notebook with the same name as a notebook, file, or folder (excluding file extensions).

即使存在不同的文件扩展名，也会发生命名冲突。 例如，以下两个文件冲突：

  • notebook.ipynb
  • notebook.py

图示：笔记本、文件或文件夹的名称冲突。

若要修复冲突，请重命名导致错误状态的笔记本、文件或文件夹。 如果克隆存储库时出错，请重命名远程 Git 存储库中的笔记本、文件或文件夹。

错误建议重新定位

There was a problem with deleting folders. The repo could be in an inconsistent state and re-cloning is recommended.

此错误表示删除文件夹时出现问题，这可能会使存储库处于不一致状态。 删除并重新克隆存储库以重置其状态。

笔记本在没有用户编辑的情况下显示为已修改

如果笔记本的每一行都出现修改而不进行任何用户编辑，则更改可能是由于行尾字符所致。 Databricks 使用 Linux 风格的行尾符，与 Windows 系统上提交的文件可能不同。

若要诊断此问题，请检查是否具有 .gitattributes 文件。 如果这样做：

  • 它不能包含 * text eol=crlf。
  • 如果不使用 Windows，请删除此设置。 开发环境和 Databricks 都使用 Linux 行尾。
  • 如果使用 Windows，请将设置更改为 * text=auto。 然后，Git 在内部使用 Linux 样式的行结束符存储文件，但检出时会自动转换为平台特定的行结束符。

如果已将包含 Windows 行尾字符的文件提交到 Git 中，请执行以下步骤：

  1. 清除所有未完成的更改。
  2. 请按照上述说明更新.gitattributes文件，以适应你的环境。
  3. 提交更改。
  4. 运行 git add --renormalize。 提交并推送所有更改。
  • Last updated on