Snowflake 中的 Git 故障排除

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

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

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

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

    有关从 Snowflake 进行身份验证的更多信息,请参阅 创建包含用于身份验证的凭据的密钥

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

    阅读有关指定 允许的前缀源 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 BRANCHESSHOW GIT TAGS 命令时的错误消息:“Processing aborted due to error”

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

为确保您从优化中受益(并停止收到此错误),请使用 REPLACE GIT REPOSITORY 重新创建您的 Git 存储库暂存区。

语言: 中文