Snowflake 中的 Git 故障排除

使用本主题中描述的提示，解决在 Snowflake 中使用 Git 存储库时出现的问题。

错误消息“Failed to access the Git repository.Operation 'clone' is not authorized”

您可能会因为多种原因看到此消息，但通常是由于 Snowflake 与远程 Git 存储库集成时配置错误。要消除常见的配置错误问题，请确认以下内容：

  • 您正在使用正确的凭据对远程 Git 存储库进行身份验证，例如正确的用户名和密码组合或正确的个人访问令牌。

    有关从 Snowflake 进行身份验证的更多信息，请参阅 设置 Snowflake 以使用 Git。

  • 您已经正确配置 Git 存储库 URL，包括 API 配置中允许的前缀。

    在 设置 Snowflake 以使用 Git 中阅读有关指定允许的前缀和来源 URL 的更多信息。

  • 您没有遇到连接问题，例如存储库位于专用网络中时。

    仅允许通过公共网络从 Snowflake 访问远程 Git 存储库。有关更多信息，请参阅 Snowflake 中的 Git 限制。

如果在确认配置正确后仍然遇到此问题，请尝试以下操作：

  • 如果您使用细粒度令牌进行授权（而不是经典令牌），请确认您已在令牌上设置了正确的权限。对于只读访问，将“Content”设置为“read-only”就足够了。

    有关在 GitHub 中管理个人访问令牌的信息，请参阅 GitHub 文档中的 管理您的个人访问令牌 (https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens)。

  • 在 Snowflake 外部，使用导致 Snowflake 中错误的相同 URL 和 TOKEN 值，通过命令行 Git 客户端克隆存储库。

    这样应该会生成更详细的输出，包括指示问题可能是什么的消息。例如，从命令行克隆可能会失败，因为操作需要 SSO 授权，而细粒度令牌无法使用此授权。切换到经典令牌可能会解决此问题。

使用 SHOW GIT BRANCHES 或 SHOW GIT TAGS 命令时的错误消息：“Processing aborted due to error”

如果您在早期预览该功能时使用了 Snowflake 中的 Git，您可能会看到这条消息。后续版本优化了从远程 Git 存储库的读取，可能会使对远程存储库的访问变得复杂，因为您在早期预览中已为其配置了访问权限。

为确保您从优化中受益（并停止收到此错误），请使用 REPLACE GIT REPOSITORY 重新创建 Git 存储库克隆。

错误消息：“Private endpoint corresponding to service name xxx does not exist.”

如果您没有为要访问的域名（服务）创建专用端点，则可能会看到此消息。

确保您已在 Snowflake 中配置专用端点并在云提供商端批准了该端点。有关更多信息，请参阅 配置专用链接连接。

错误消息：“Failed to perform operation 'clone'. SSL problems when connect to Git server”

当 HTTPS 证书出现问题时，您可能会看到此消息。例如，该域名的证书未由证书颁发机构签名，或者其链中不包含 Git 服务器域名。

语言: 中文