Résolution des erreurs pour les dossiers Git Databricks

Cette page décrit les erreurs courantes et le comportement inattendu lors de l’utilisation de Azure Databricks dossiers Git avec un fournisseur Git distant, regroupé par catégorie pour vous aider à identifier la cause plus rapidement. Si aucun des conseils ici ne résout votre problème, consultez Obtenir de l’aide.

Erreurs d’authentification

Ces erreurs se produisent lorsque Azure Databricks ne peut pas vérifier votre identité auprès du fournisseur Git distant.

Invalid credentials

Essayez ce qui suit :

• Vérifiez que les paramètres d’intégration Git (Paramètres>comptes liés) sont corrects. Vous devez entrer vos nom d’utilisateur et jeton de fournisseur Git.

• Vérifiez que vous avez sélectionné le fournisseur Git correct dans Paramètres>Comptes liés.

• Vérifiez que votre jeton d’accès personnel ou votre mot de passe d’application dispose de l’accès correct au référentiel.

• Si votre fournisseur Git a activé l’authentification unique, autorisez vos jetons pour l’authentification unique.

• Testez votre jeton avec la ligne de commande Git. Remplacez les chaînes de texte entre crochets :

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

Erreurs de connexion SSL

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

Cette erreur se produit lorsque Azure Databricks ne peut pas atteindre votre serveur Git via HTTPS. Il indique généralement un problème de connectivité réseau ou un problème de certificat TLS sur l’infrastructure Git de votre organisation.

Avant de contacter votre équipe de compte Azure Databricks, disposez des informations suivantes :

• URL de votre serveur Git
• Indique si le serveur utilise un certificat d’autorité de certification auto-signé ou privé
• Indique si d’autres utilisateurs dans le même espace de travail voient la même erreur

Erreur d’identifiants 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.

Cette erreur peut se produire lorsque votre organisation a récemment activé une stratégie d’authentification multifacteur (MFA). Lorsque l’application de l’authentification multifacteur prend effet, les sessions Microsoft Entra ID existantes peuvent ne pas satisfaire aux nouvelles exigences d’authentification et la connexion échoue.

Pour résoudre l’erreur :

1. Accédez à portal.azure.com et déconnectez-vous de Microsoft Entra ID.
2. Reconnectez-vous. Vous devriez voir s’afficher une invite vous demandant de finaliser l’authentification multifacteur.

Si cela ne fonctionne pas, déconnectez-vous de tous les services Azure avant de vous reconnecter.

Erreurs d’état du référentiel

Ces erreurs se produisent lorsque le dossier Git local atteint un état qui empêche les opérations normales.

État de tête détaché

Dans Git, la « tête » fait référence à la position actuelle dans l’historique de validation, et elle pointe normalement vers une branche. Lorsque HEAD pointe directement sur un commit spécifique plutôt que sur une branche, le dépôt est dans un état de « HEAD détachée ». Git ne suit pas les modifications apportées dans cet état sur n’importe quelle branche. Si vous quittez cette page sans avoir d’abord créé une nouvelle branche, ces modifications risquent d’être perdues.

Un dossier Git peut entrer l’état principal détaché lorsque :

• Une personne supprime la branche distante. Azure Databricks tente de récupérer les modifications locales non validées en les appliquant à la branche par défaut. S’il existe des modifications en conflit, Azure Databricks les applique à un instantané de la branche par défaut, ce qui entraîne une tête détachée.
• Un utilisateur ou un principal de service extrait une balise à l’aide de l’APIupdate repo.

Pour se remettre de cet état :

1. Cliquez sur Créer une branche pour créer une branche à partir de la validation actuelle, ou Sélectionnez une branche pour extraire une branche existante.
2. Validez et envoyez (push) pour conserver vos modifications. Pour ignorer les modifications, cliquez sur Menu kebab sous Modifications.

État du référentiel incohérent

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

Cette erreur indique qu’un problème s’est produit lors de la suppression de dossiers. Le référentiel est désormais dans un état incohérent. Supprimez et clonez à nouveau le référentiel pour réinitialiser son état.

Conflits de noms de bloc-notes

Les blocs-notes avec des noms de fichiers identiques ou similaires peuvent entraîner des erreurs lors de la création d’un référentiel ou d’une demande de tirage :

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

Les conflits d’affectation de noms peuvent se produire même avec différentes extensions de fichier. Par exemple, ces deux fichiers sont en conflit :

• notebook.ipynb
• notebook.py

Pour résoudre le conflit, renommez le bloc-notes, le fichier ou le dossier qui contribue à l’état d’erreur. Si l’erreur se produit lorsque vous clonez le dépôt, renommez les blocs-notes, fichiers ou dossiers dans le référentiel Git distant.

Comportement inattendu

Ces problèmes ne produisent pas de message d’erreur clair, mais ils sont des signes d’un problème nécessitant une investigation.

Erreurs de délai d’expiration

Les opérations telles que le clonage d’un dépôt volumineux ou l’extraction d’une branche volumineuse peuvent entraîner des erreurs de délai d’expiration. L’opération peut quand même s’achever en arrière-plan après l’expiration du délai.

Si vous voyez une erreur de délai d’expiration :

1. Patientez quelques minutes, puis actualisez le dossier Git. Si les fichiers ou branches attendus sont présents, l’opération s’est terminée avec succès.
2. Si l’espace de travail était sous une charge importante, réessayez l’opération après la diminution de la charge.

Pour éviter les délais d’expiration avec des dépôts volumineux, utilisez l’extraction éparse pour travailler uniquement avec les fichiers dont vous avez besoin.

Erreurs 404

Si vous obtenez une erreur 404 lorsque vous ouvrez un fichier non-notebook, patientez quelques minutes et réessayez. Il existe un court délai entre le moment où le système active l’espace de travail et lorsque l’application web récupère la configuration.

Les blocs-notes semblent avoir été modifiés sans que l’utilisateur les ait modifiés

Si chaque ligne d’un bloc-notes apparaît modifiée sans modification de l’utilisateur, les modifications sont probablement dues aux différences de fin de ligne. Azure Databricks utilise des fins de ligne de type Linux (LF), qui peuvent être différentes de celles des fichiers validés sur des systèmes Windows (CRLF).

Pour diagnostiquer ce problème, vérifiez si vous avez un .gitattributes fichier :

• Il ne peut pas contenir * text eol=crlf.
• Si vous n’utilisez pas Windows, supprimez ce paramètre. Votre environnement de développement et Azure Databricks utilisent des fins de ligne Linux.
• Si vous utilisez Windows, remplacez le paramètre * text=autopar . Git stocke ensuite les fichiers avec des terminaisons de ligne de style Linux en interne, mais extrait automatiquement les terminaisons de ligne spécifiques à la plateforme.

Si vous avez déjà validé des fichiers avec des caractères de fin de ligne Windows dans Git :

1. Effacez les modifications en attente.
2. Mettez à jour le .gitattributes fichier comme décrit ci-dessus pour votre environnement.
3. Validez la modification.
4. Exécutez git add --renormalize. Validez et poussez toutes les modifications.

Récupérer des fichiers supprimés

La récupération des fichiers varie selon l’action. Certaines actions autorisent la récupération via le dossier Corbeille , tandis que d’autres ne le font pas. Pour restaurer des fichiers précédemment validés et envoyés à une branche distante, utilisez l’historique de validation Git du référentiel distant :

Action	Le fichier est-il récupérable ?
Supprimer un fichier avec un navigateur d’espace de travail	Oui, à partir du dossier Corbeille
Ignorer un nouveau fichier avec la boîte de dialogue du dossier Git	Oui, à partir du dossier Corbeille
Ignorer un fichier modifié avec la boîte de dialogue Dossier Git	Non, le fichier est parti
reset (dur) pour les modifications de fichier non validées	Non, les modifications de fichier sont supprimées
reset (dur) pour les fichiers non validés, nouvellement créés	Non, les modifications de fichier sont supprimées
Changer de branches avec la boîte de dialogue Dossier Git	Oui, à partir du dépôt Git distant
Autres opérations Git, telles que la validation ou l’envoi (push) à partir de la boîte de dialogue de dossier Git	Oui, à partir du dépôt Git distant
PATCH opérations de mise à jour /repos/id à partir de l’API Repos	Oui, à partir du dépôt Git distant

Obtenir de l’aide

Si aucune des instructions de cette page ne résout votre problème, contactez Azure Databricks support technique. Lorsque vous contactez le support technique, incluez les éléments suivants :

• Message d’erreur exact
• Nom de votre fournisseur Git et indique si le référentiel est public ou privé
• Indique si le problème affecte tous les utilisateurs ou seulement certains utilisateurs de votre espace de travail
• Les étapes que vous avez déjà essayées