Git-Versionskontrolle für Notebooks (Legacy)

Wichtig

Die Unterstützung für die Git-Integration von Legacy-Notebooks wurde am 31. Januar 2024 eingestellt. Databricks empfiehlt die Verwendung von Databricks Git Ordnern, um Ihre Arbeit in Databricks mit einem Git-Remoterepository zu synchronisieren.

In diesem Artikel erfahren Sie, wie Sie die Git-Versionskontrolle für Notebooks (Legacyfeature) einrichten. Sie können auch die Databricks CLI oder die Arbeitsbereichs-API verwenden, um Notebooks zu importieren und zu exportieren und um Git-Vorgänge in Ihrer lokalen Entwicklungsumgebung durchzuführen.

Aktivieren und Deaktivieren der Git-Versionsverwaltung

Die Versionskontrolle ist standardmäßig aktiviert. So schalten Sie diese Einstellung um

  1. Gehen Sie zu Einstellungen>Arbeitsbereichseinstellungen.
  2. Deaktivieren Sie im Abschnitt Erweitert die Umschaltfläche Git-Versionsverwaltung für Notebooks.

Konfigurieren der Versionskontrolle

Zum Konfigurieren der Versionskontrolle erstellen Sie bei Ihrem Git-Provider Zugangsdaten und fügen diese anschließend in Azure Databricks hinzu.

Arbeiten mit Notebookversionen

Im Verlaufsbereich arbeiten Sie mit Notebookversionen. Öffnen Sie den Verlaufsbereich, indem Sie auf der rechten Randleiste Symbol für Versionsverlauf auswählen.

Versionsverlauf

Hinweis

Sie können ein Notebook nicht ändern, während der Verlaufsbereich geöffnet ist.

  1. Wählen Sie auf der rechten Randleiste Symbol für Versionsverlauf aus. Auf der Git-Statusleiste wird der Status Git: Nicht verknüpft angezeigt.

    Git-Statusleiste

  2. Klicken Sie auf Git: Nicht verknüpft.

    Es wird das Dialogfeld „Git-Einstellungen“ angezeigt. Wenn Sie Ihr Notebook zum ersten Mal öffnen, lautet der Status Verknüpfung aufheben, da sich das Notebook nicht in GitHub befindet.

    Git-Einstellungen: neues Notebook verknüpfen

  3. Klicken Sie im Feld „Status“ auf Link.

  4. Fügen Sie im Feld „Link“ die URL des GitHub-Repositorys ein.

  5. Klicken Sie auf die Dropdownliste Verzweigung. Wählen Sie eine Verzweigung aus, oder geben Sie den Namen einer neuen Verzweigung ein.

  6. Geben Sie im Feld „Pfad im Git-Ordner“ an, wo Ihre Datei im Repository gespeichert werden soll.

    Für Python-Notebooks lautet die vorgeschlagene Standarddateierweiterung .py. Wenn Sie .ipynb verwenden, wird Ihr Notebook im iPython-Notebookformat gespeichert. Ist die Datei bereits in GitHub vorhanden, können Sie die URL der Datei direkt kopieren und einfügen.

  7. Klicken Sie auf Speichern, um die Verknüpfung Ihres Notebooks abzuschließen. Ist die Datei noch nicht vorhanden, wird eine Eingabeaufforderung mit der Option Diese Datei in Ihrem GitHub-Repository speichern angezeigt.

  8. Geben Sie eine Nachricht ein, und klicken Sie auf Speichern.

Speichern eines Notebooks in GitHub

Während die Änderungen, die Sie an Ihrem Notebook vornehmen, automatisch im Azure Databricks-Versionsverlauf gespeichert werden, werden die Änderungen in GitHub nicht automatisch beibehalten.

  1. Wählen Sie auf der rechten Randleiste Symbol für Versionsverlauf aus, um den Verlaufsbereich zu öffnen.

    Verlauf – jetzt speichern

  2. Klicken Sie auf Jetzt speichern, um Ihr Notebook in GitHub zu speichern. Das Dialogfeld „Notebookversion speichern“ wird angezeigt.

  3. Optional können Sie eine Beschreibung der Änderung eingeben.

  4. Stellen Sie sicher, dass die Option Commit auch in Git durchführen aktiviert ist.

    Version speichern

  5. Klicken Sie auf Speichern.

Ein Notebook auf eine Version aus GitHub zurücksetzen oder aktualisieren

Sobald Sie ein Notebook verknüpft haben, synchronisiert Azure Databricks Ihren Verlauf jedes Mal mit Git, wenn Sie das Verlauf-Fenster erneut öffnen. Versionen, die mit Git synchronisiert werden, enthalten einen Commithash als Teil des Eintrags.

  1. Wählen Sie auf der rechten Randleiste Symbol für Versionsverlauf aus, um den Verlaufsbereich zu öffnen.

    Chronikfenster

  2. Wählen Sie im Verlaufsbereich einen Eintrag aus. Azure Databricks zeigt diese Version an.

  3. Klicken Sie auf Diese Version wiederherstellen.

  4. Klicken Sie auf Bestätigen, um zu bestätigen, dass Sie diese Version wiederherstellen möchten.

  1. Wählen Sie auf der rechten Randleiste Symbol für Versionsverlauf aus, um den Verlaufsbereich zu öffnen.

  2. Auf der Git-Statusleiste wird der Status Git: Synchronisiert angezeigt.

    Verlaufsbereich: Image jetzt speichern

  3. Klicken Sie auf Git: Synchronisiert.

    Git-Einstellungen: Verknüpfung des Notebooks aufheben

  4. Klicken Sie im Dialogfeld „Git-Einstellungen“ auf Verknüpfung aufheben.

  5. Klicken Sie auf Speichern.

  6. Klicken Sie auf Bestätigen, um zu bestätigen, dass Sie die Verknüpfung des Notebooks mit der Versionskontrolle aufheben möchten.

Verwenden von Verzweigungen

Sie können in jeder Verzweigung Ihres Repositorys arbeiten und neue Verzweigungen innerhalb von Azure Databricks erstellen.

Branch erstellen

  1. Wählen Sie auf der rechten Randleiste Symbol für Versionsverlauf aus, um den Verlaufsbereich zu öffnen.

  2. Klicken Sie auf die Git-Statusleiste, um den GitHub-Bereich zu öffnen.

  3. Klicken Sie auf das Dropdown-Menü Branch.

  4. Geben Sie einen Branch-Namen ein.

    Verzweigung erstellen

  5. Klicken Sie am unteren Ende der Dropdownliste auf die Option Verzweigung erstellen. Der übergeordnete Branch wird angezeigt. Die neue Verzweigung wird immer ausgehend von der aktuell ausgewählten Verzweigung erstellt.

Erstellen eines Pull Requests

  1. Wählen Sie auf der rechten Randleiste Symbol für Versionsverlauf aus, um den Verlaufsbereich zu öffnen.

  2. Klicken Sie auf die Git-Statusleiste, um den GitHub-Bereich zu öffnen.

    Git-Einstellungen: Pull Request erstellen

  3. Klicken Sie auf PR erstellen. GitHub wird in einer Pull Request-Seite für den Branch geöffnet.

Einen Branch rebasen

Sie können Ihren Branch auch innerhalb von Azure Databricks rebasen. Der Link Rebase wird angezeigt, wenn im übergeordneten Branch neue Commits vorliegen. Nur ein Rebase auf Basis des Standard-Branches des übergeordneten Repositorys wird unterstützt.

Rebase

Nehmen wir zum Beispiel an, dass Sie an databricks/reference-apps arbeiten. Sie forken es in Ihr eigenes Konto (zum Beispiel brkyvz) und beginnen dann, auf einem Branch namens my-branch zu arbeiten. Bei einem neuen Update für databricks:master wird nun die Schaltfläche Rebase angezeigt, über die Sie die Änderungen per Pull in Ihre Verzweigung brkyvz:my-branch übertragen können.

Rebasing funktioniert in Azure Databricks etwas anders. Nehmen Sie als Beispiel folgende Verzweigungsstruktur:

Verzweigungsstruktur vor dem Rebasevorgang

Nach dem Rebasevorgang sieht die Branchstruktur folgendermaßen aus:

Verzweigungsstruktur nach dem Rebasevorgang

Der Unterschied besteht darin, dass die Commits C5 und C6 nicht auf Grundlage von C4 gelten. Sie werden in Ihrem Notebook als lokale Änderungen angezeigt. Mergekonflikte werden wie folgt angezeigt:

Mergekonflikt

Über die Schaltfläche Jetzt speichern können Sie einen erneuten Commit zu GitHub ausführen.

Was passiert, wenn jemand von meinem Branch abgezweigt ist, den ich gerade gerebased habe?

Wenn Ihre Verzweigung (zum Beispiel branch-a) als Basis für eine andere Verzweigung (branch-b) diente und Sie sie rebasen, müssen Sie sich keine Sorgen machen! Sobald der andere Benutzer auch ein Rebase für branch-b ausführt, funktioniert alles reibungslos. Für diese Situationen hat sich die Nutzung separater Verzweigungen für separate Notebooks bewährt.

Bewährte Methoden für Codereviews

Azure Databricks unterstützt Git-Verzweigungen.

  • Sie können ein Notebook mit jedem Branch in einem Repository verbinden. Azure Databricks empfiehlt, für jedes Notebook einen separaten Branch zu verwenden.
  • Während der Entwicklung können Sie ein Notebook mit einem Fork eines Repositorys oder mit einem Branch im Haupt-Repository verknüpfen, der nicht der Standard-Branch ist. Für eine Upstreamintegration Ihrer Änderungen können Sie in Azure Databricks über den Link PR erstellen im Dialogfeld Git-Einstellungen einen GitHub-Pull Request erstellen. Der Link „PR erstellen“ wird nur angezeigt, wenn Sie nicht in der Standardverzweigung des übergeordneten Repositorys arbeiten.

Problembehandlung

Sollten bei Ihnen Fehler im Zusammenhang mit der Synchronisierung des GitHub-Verlaufs auftreten, überprüfen Sie Folgendes:

  • Sie können ein Notizbuch nur mit einem initialisierten Git-Repository verknüpfen, das nicht leer ist. Testen Sie die URL in einem Webbrowser.
  • Das persönliche GitHub-Zugriffstoken muss aktiv sein.
  • Um ein privates GitHub-Repository verwenden zu können, müssen Sie über die Berechtigung zum Lesen des Repositorys verfügen.
  • Wenn ein Notebook mit einer GitHub-Verzweigung verknüpft ist, die umbenannt wird, wird die Änderung nicht automatisch in Azure Databricks widergespiegelt. Sie müssen das Notebook manuell erneut mit dem Branch verknüpfen.

Zu Databricks Git-Ordnern migrieren

Benutzer*innen, die von der Git-Legacyversionskontrolle zu Databricks Git-Ordnern migrieren möchten, können den folgenden Leitfaden verwenden:

  • Last updated on