Fehlerbehebung für Git-Ordner von Databricks

Diese Seite enthält Anleitungen für häufige Fehlermeldungen und die Problembehandlung bei Git-Ordnern von Databricks.

Invalid credentials

Probieren Sie Folgendes aus:

• Vergewissern Sie sich, dass die Git-Integrationseinstellungen (Einstellungen>Verknüpfte Konten) korrekt sind. Sie müssen sowohl den Benutzernamen Ihres Git-Anbieters als auch Ihr Token eingeben.

• Vergewissern Sie sich, dass Sie den richtigen Git-Anbieter in >"Verknüpfte Einstellungen" ausgewählt haben.

• Überprüfen Sie, ob Ihr persönliches Zugriffstoken oder App-Kennwort über den richtigen Repositoryzugriff verfügt.

• Wenn Ihr Git-Anbieter SSO aktiviert hat, autorisieren Sie Ihre Token für SSO.

• Testen Sie Ihr Token mit der Git-Befehlszeile. Ersetzen Sie die Textzeichenfolgen in spitzen Klammern:

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

Secure connection...SSL problems

Dieser Fehler tritt auf, wenn Azure Databricks nicht auf Ihren Git-Server zugreifen kann. Wenden Sie sich an Ihr Azure Databricks-Kontoteam, um auf einen privaten Git-Server zuzugreifen.

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

Microsoft Entra ID-Anmeldeinformationsfehler

Encountered an error with your :re[ms-entra-id] credentials. Try logging out of :re[ms-entra-id] and logging back in.

Dieser Fehler kann auftreten, wenn Ihr Team kürzlich eine mehrstufige Authentifizierungsrichtlinie (Multi-Factor Authentication, MFA) verwendet hat. Um den Fehler zu beheben, melden Sie sich bei portal.azure.com von Microsoft Entra-ID ab. Wenn Sie sich wieder anmelden, sollte eine Aufforderung zur Verwendung von MFA angezeigt werden.

Wenn dies nicht funktioniert, versuchen Sie, sich von allen Azure-Diensten abzumelden, bevor Sie sich erneut anmelden.

Timeoutfehler

Vorgänge wie das Klonen eines großen Repositorys oder das Auschecken eines großen Branches können zu Timeout-Fehlern führen. Der Vorgang kann jedoch im Hintergrund abgeschlossen werden. Versuchen Sie es später erneut, wenn der Arbeitsbereich stark belastet wurde.

Wenn Sie mit einem großen Repository arbeiten wollen, versuchen Sie es mit sparse checkout.

404-Fehler

Wenn beim Öffnen einer Nicht-Notizbuchdatei ein Fehler von 404 angezeigt wird, warten Sie einige Minuten, und versuchen Sie es erneut. Es gibt eine kurze Verzögerung zwischen dem Zeitpunkt, an dem das System den Arbeitsbereich aktiviert und wenn die Webapp die Konfiguration aufnimmt.

Zustand Detached Head

Ein Databricks Git-Ordner kann in den Zustand des „detached head“ gelangen, wenn:

• Jemand löscht den Remote-Branch. Databricks versucht, nicht übertragene lokale Änderungen wiederherzustellen, indem diese auf den Standardzweig angewendet werden. Wenn widersprüchliche Änderungen vorliegen, wendet Databricks sie auf eine Momentaufnahme des Standardzweigs (abgelöster Kopf) an.
• Ein Benutzer oder Dienstprinzipal hat ein Tag mit der update repo API ausgecheckt.

So stellen Sie diesen Zustand wieder her:

1. Klicken Sie auf "Verzweigung erstellen", um eine neue Verzweigung aus dem aktuellen Commit zu erstellen, oder auf "Verzweigung auswählen ", um eine vorhandene Verzweigung auszuchecken.
2. Commit und Pushen, um Ihre Änderungen zu speichern. Um Änderungen zu verwerfen, klicken Sie auf das Kebab-Menü unter "Änderungen".

Notebook-Namenskonflikte lösen

Notizbücher mit identischen oder ähnlichen Dateinamen können Fehler verursachen, wenn Sie ein Repository oder einen Pull-Request erstellen, z. B. Cannot perform Git operation due to conflicting names oder A folder cannot contain a notebook with the same name as a notebook, file, or folder (excluding file extensions).

Namenskonflikte können auch bei verschiedenen Dateierweiterungen auftreten. Diese beiden Dateien stehen beispielsweise im Konflikt:

• notebook.ipynb
• notebook.py

Um den Konflikt zu beheben, benennen Sie das Notizbuch, die Datei oder den Ordner um, die zum Fehlerstatus beitragen. Wenn der Fehler auftritt, wenn Sie das Repository klonen, benennen Sie die Notizbücher, Dateien oder Ordner im Git-Remote-Repository um.

Fehler weisen auf ein erneutes Klonen hin

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

Dieser Fehler weist darauf hin, dass beim Löschen von Ordnern ein Problem aufgetreten ist, das das Repository in einem inkonsistenten Zustand belassen kann. Löschen Sie das Repository, und klonen Sie es erneut, um den Status zurückzusetzen.

Notizbücher werden ohne Benutzerbearbeitungen geändert

Wenn jede Zeile eines Notizbuchs ohne Benutzerbearbeitungen geändert wird, sind die Änderungen wahrscheinlich auf Zeilenendezeichen zurückzuführen. Databricks verwendet Zeilenenden im Linux-Stil, die sich von Dateien unterscheiden können, die auf Windows-Systemen zugesichert werden.

Um dieses Problem zu diagnostizieren, überprüfen Sie, ob Sie über eine .gitattributes-Datei verfügen. Wenn ja:

• Er kann nicht enthalten * text eol=crlf.
• Wenn Sie Windows nicht verwenden, entfernen Sie diese Einstellung. Sowohl Ihre Entwicklungsumgebung als auch Databricks verwenden Linux-Zeilenenden.
• Wenn Sie Windows verwenden, ändern Sie die Einstellung in * text=auto. Git speichert dann Dateien mit Linux-Linienenden intern, checkt aber automatisch mit plattformspezifischen Zeilenenden aus.

Wenn Sie bereits Dateien mit Windows-Zeilenendezeichen in Git zugesichert haben, führen Sie die folgenden Schritte aus:

1. Löschen Sie alle ausstehenden Änderungen.
2. Aktualisieren Sie die .gitattributes Datei wie oben beschrieben für Ihre Umgebung.
3. Führen Sie für die Änderung einen Commit aus.
4. Führen Sie git add --renormalize aus. Führen Sie einen Commit aus, und pushen Sie alle Änderungen.