Resolução de erros para pastas Databricks Git

Esta página descreve erros comuns e comportamentos inesperados ao utilizar pastas Git do Azure Databricks com um fornecedor Git remoto, agrupados por categoria para ajudar a identificar a causa mais rapidamente. Se nenhuma das orientações aqui resolver o seu problema, consulte Pedir ajuda.

Erros de autenticação

Estes erros ocorrem quando o Azure Databricks não consegue verificar a sua identidade com o fornecedor Git remoto.

Invalid credentials

Experimente o seguinte:

• Confirme se as configurações de integração do Git (Configurações>de contas vinculadas) estão corretas. Você deve inserir o nome de usuário e o token do provedor Git.

• Confirma que selecionaste o fornecedor Git correto nas Definições>Contas Ligadas.

• Verifique se o seu token de acesso pessoal ou a palavra-passe da aplicação tem o acesso correto ao repositório.

• Se o teu fornecedor Git tiver SSO ativado, autoriza os teus tokens para SSO.

• Teste seu token com a linha de comando do Git. Substitua as cadeias de texto entre colchetes angulares:

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

Erros de ligação SSL

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

Este erro ocorre quando o Azure Databricks não consegue aceder ao seu servidor Git via HTTPS. Normalmente indica um problema de conectividade de rede ou um problema de certificado TLS na infraestrutura Git da sua organização.

Antes de contactar a sua equipa de contas Azure Databricks, tenha preparada a seguinte informação:

• A URL do seu servidor Git
• Quer o servidor utilize um certificado de CA auto-assinado ou privado
• Se outros utilizadores no mesmo espaço de trabalho veem o mesmo erro

Erro de credenciais do 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.

Este erro pode ocorrer quando a sua organização ativou recentemente uma política de autenticação multifator (MFA). Quando a aplicação da MFA entra em vigor, as sessões existentes do Microsoft Entra ID podem não satisfazer os novos requisitos de autenticação e a ligação falha.

Para resolver o erro:

1. Vá a portal.azure.com e termine sessão no Microsoft Entra ID.
2. Inicie sessão novamente. Deves ver um prompt para concluir o MFA.

Se isso não resultar, saia de todos os serviços do Azure antes de voltar a iniciar sessão.

Erros de estado do repositório

Estes erros ocorrem quando a pasta Git local atinge um estado que impede operações normais.

Estado-chefe desligado

No Git, o "head" refere-se à posição atual no histórico de confirmações e normalmente aponta para um ramo. Quando a cabeça aponta diretamente para um commit específico em vez de um branch, o repositório encontra-se num estado de "cabeça destacada". O git não regista alterações feitas neste estado em nenhum ramo. Se se afastar sem criar primeiro uma nova ramificação, essas alterações podem perder-se.

Um repositório Git pode entrar no estado detached HEAD quando:

• Alguém apaga a agência remota. O Azure Databricks tenta recuperar alterações locais não comprometidas aplicando-as ao branch predefinido. Se houver alterações conflitantes, o Azure Databricks aplica-as num instantâneo do branch predefinido, resultando numa cabeça destacada.
• Um utilizador ou principal de serviço verifica uma etiqueta usando a update repo API.

Para recuperar-se deste estado:

1. Clique em Criar ramo para criar um branch a partir do commit atual, ou selecione branch para verificar um branch existente.
2. Compromete-te e esforça-te para manter as tuas mudanças. Para descartar alterações, clique no debaixo de Alterações.

Estado inconsistente do repositório

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

Este erro indica que ocorreu um problema ao eliminar pastas. O repositório encontra-se agora num estado inconsistente. Apague e clone novamente o repositório para redefinir o seu estado.

Conflitos de nomes de cadernos

Cadernos com nomes de ficheiros idênticos ou semelhantes podem causar erros ao criar um repositório ou pull request:

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).

Conflitos de nomeação podem ocorrer mesmo com diferentes extensões de ficheiro. Por exemplo, esses dois arquivos entram em conflito:

• notebook.ipynb
• notebook.py

Para resolver o conflito, renomeie o caderno, ficheiro ou pasta que está a contribuir para o estado do erro. Se o erro ocorrer ao clonar o repositório, renomeie os cadernos, ficheiros ou pastas no repositório Git remoto.

Comportamento inesperado

Estes problemas não produzem uma mensagem de erro clara, mas são sinais de um problema que necessita de investigação.

Erros de tempo limite

Operações como clonar um grande repositório ou verificar um grande ramo podem resultar em erros de timeout. A operação pode ainda ser concluída em segundo plano após o tempo limite.

Se aparecer um erro de tempo limite:

1. Espera alguns minutos e depois atualiza a pasta Git. Se os ficheiros ou ramificações esperadas estiverem presentes, a operação foi concluída com sucesso.
2. Se o espaço de trabalho estivesse sob grande carga, tente novamente a operação após a diminuição da carga.

Para evitar timeouts com repositórios grandes, use o sparse checkout para trabalhar apenas com os ficheiros de que precisa.

404 erros

Se aparecer um erro 404 ao abrir um ficheiro que não seja do caderno, espere alguns minutos e tente novamente. Há um breve atraso entre o momento em que o sistema ativa o espaço de trabalho e quando a aplicação web adota a configuração.

Os blocos de notas parecem modificados sem que o utilizador os edite

Se cada linha de um caderno parecer modificada sem quaisquer edições do utilizador, as alterações devem-se provavelmente a diferenças no final da linha. O Azure Databricks utiliza terminações de linha ao estilo Linux (LF), que podem diferir dos ficheiros comprometidos em sistemas Windows (CRLF).

Para diagnosticar este problema, verifique se tem um .gitattributes ficheiro:

• Não consegue conter * text eol=crlf.
• Se não estiveres a usar Windows, remove esta definição. Tanto o teu ambiente de desenvolvimento como o Azure Databricks usam terminações de linha Linux.
• Se estiveres a usar Windows, altera a definição para * text=auto. O Git armazena então ficheiros com terminações de linha ao estilo Linux internamente, mas verifica automaticamente com terminações de linha específicas da plataforma.

Se já fizeste commit de ficheiros com caracteres de fim de linha do Windows no Git:

1. Limpe todas as alterações pendentes.
2. Atualize o .gitattributes ficheiro conforme descrito acima para o seu ambiente.
3. Confirme a alteração.
4. Executar git add --renormalize. Confirme e envie todas as alterações.

Recuperar ficheiros apagados

A recuperabilidade do ficheiro varia consoante a ação. Algumas ações permitem a recuperação através da pasta Lixo , enquanto outras não. Para restaurar ficheiros previamente comprometidos e enviados para um branch remoto, use o histórico de commit Git do repositório remoto:

Obter ajuda

Se nenhuma das orientações desta página resolver o seu problema, contacte o suporte do Azure Databricks. Quando contactar o suporte, inclua o seguinte:

• A mensagem de erro exata
• O nome do seu fornecedor Git e se o repositório é público ou privado
• Se o problema afeta todos os utilizadores ou apenas alguns utilizadores no seu espaço de trabalho
• Os passos que já experimentaste