Résolution des erreurs pour les dossiers Git Databricks

Cette page fournit des conseils pour les messages d’erreur courants et la résolution des problèmes liés aux dossiers Git Databricks.

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
  

Secure connection...SSL problems

Cette erreur se produit si Azure Databricks ne peut pas accéder à votre serveur Git. Pour accéder à un serveur Git privé, contactez votre équipe de compte Azure Databricks.

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

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 si votre équipe a récemment commencé à utiliser une stratégie d’authentification multifacteur (MFA). Pour résoudre l’erreur, accédez à portal.azure.com et déconnectez-vous de Microsoft Entra ID. Lorsque vous vous reconnectez, vous devriez voir une invite à utiliser l’authentification multifacteur.

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

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. Toutefois, l’opération peut se terminer en arrière-plan. Réessayez ultérieurement si l’espace de travail était sous une charge importante.

Pour utiliser un dépôt volumineux, essayez l'extraction partielle.

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.

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 :

État de tête détachée

Un dossier Git Databricks peut basculer dans l’état de tête détachée si :

• Une personne supprime la branche distante. 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, Databricks les applique à un instantané de la branche par défaut (tête détachée).
• Un utilisateur ou un principal de service a 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.

Résoudre les conflits de noms de carnets

Les blocs-notes avec des noms de fichiers identiques ou similaires peuvent provoquer des erreurs lorsque vous créez un dépôt ou une pull request, comme par exemple Cannot perform Git operation due to conflicting names ou 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.

Les erreurs suggèrent le reclonage

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, ce qui peut laisser le référentiel dans un état incohérent. Supprimez et clonez à nouveau le référentiel pour réinitialiser son état.

Les blocs-notes apparaissent modifiés sans modification de l’utilisateur

Si chaque ligne d’un bloc-notes apparaît modifiée sans modification de l’utilisateur, les modifications sont probablement dues aux caractères de fin de ligne. Databricks utilise des terminaisons de ligne de style Linux, qui peuvent différer des fichiers validés sur les systèmes Windows.

Pour diagnostiquer ce problème, vérifiez si vous avez un fichier .gitattributes. Si c’est le cas :

• Il ne peut pas contenir * text eol=crlf.
• Si vous n’utilisez pas Windows, supprimez ce paramètre. Votre environnement de développement et Databricks utilisent des terminaisons 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, procédez comme suit :

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.