Solução de problemas do Git no Snowflake

Use as dicas descritas neste tópico para resolver problemas ao usar um repositório Git no Snowflake.

Mensagem de erro: “Falha ao acessar o repositório Git. A operação ‘clone’ não está autorizada.”

É possível ver esta mensagem por vários motivos, mas normalmente é devido a uma configuração incorreta na integração do Snowflake com o repositório Git remoto. Para eliminar problemas comuns de configuração incorreta, confirme o seguinte:

  • Você está usando as credenciais corretas para autenticação no repositório Git remoto, como uma combinação correta de nome de usuário e senha ou um token de acesso pessoal correto.

    Para mais informações sobre autenticação do Snowflake, consulte Configuração do Snowflake para usar o Git.

  • Você configurou corretamente o URL do repositório Git, incluindo os prefixos permitidos na configuração da API.

    Leia mais sobre como especificar umaURL de prefixo e de origem permitida em:doc:/developer-guide/git/git-setting-up.

  • Você não está enfrentando um problema de conectividade, como quando o repositório está em uma rede privada.

    O acesso a um repositório Git remoto do Snowflake é permitido apenas por meio de uma rede pública. Para obter mais informações, consulte Limitações do Git no Snowflake.

Se você continuar tendo esse problema após verificar se sua configuração está correta, tente o seguinte:

  • Se você estiver usando um token de granularidade fina para autorização (não o token clássico), confirme se você definiu as permissões adequadas no token. Para acesso somente leitura, configurar o “Conteúdo” como “somente leitura” deve ser suficiente.

    Para obter informações sobre como gerenciar um token de acesso pessoal no GitHub, consulte Como gerenciar seus tokens de acesso pessoal na documentação do GitHub.

  • Fora do Snowflake, clone o repositório com o cliente Git de linha de comando usando os mesmos valores de URL e TOKEN que estão resultando no erro no Snowflake.

    Isso deve gerar uma saída mais detalhada, incluindo mensagens indicando qual pode ser o problema. Por exemplo, a clonagem pode falhar na linha de comando porque a autorização SSO é necessária para a operação, e essa autorização não estava disponível para o token de granularidade fina. Mudar para um token clássico pode resolver esse problema.

Mensagem de erro: “Processamento abortado devido a erro” ao usar o comando SHOW GIT BRANCHES ou SHOW GIT TAGS.

É possível ver esta mensagem se tiver usado o Git do Snowflake durante uma versão inicial do recurso. Uma otimização na leitura de um repositório Git remoto, adicionada em um lançamento posterior, pode estar complicando o acesso a repositórios remotos para os quais você configurou o acesso naquela versão inicial.

Para garantir que você esteja se beneficiando da otimização — e para parar de receber esse erro —, recrie o clone do seu repositório Git usando REPLACE GIT REPOSITORY.

Mensagem de erro: “O ponto de extremidade privado correspondente ao nome de serviço xxx não existe.”

Você poderá ver esta mensagem se não tiver criado um ponto de extremidade privado para o domínio (serviço) que está tentando alcançar.

Certifique-se de provisionar um ponto de extremidade privado no Snowflake e aprová-lo no lado do provedor de nuvem. Para obter mais informações, consulte Configuração da conexão do Private Link.

Mensagem de erro: “Falha ao executar a operação “ clone”. Problemas do SSL ao conectar-se ao servidor Git»

Você pode ver esta mensagem quando há um problema com um certificado HTTPS. Por exemplo, o certificado do domínio não está assinado por uma autoridade de certificação ou não contém o domínio do servidor Git na cadeia.