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 Criação de um segredo com credenciais para autenticação.

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

    Leia mais sobre como especificar um prefixo e URL de origem permitidos.

  • 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 os estágios do seu repositório Git usando REPLACE GIT REPOSITORY.