Verwalten des Notizbuchformats

In diesem Artikel wird das Standardformat des Notizbuchs in Azure Databricks, das Ändern des Notizbuchformats und das Verwalten von Ausgabe-Commits beschrieben, wenn sich Ihr Notizbuch in einem quellgesteuerten Ordner befindet.

Standardmäßig werden Notizbücher in Databricks im .ipynb Format (IPython oder Jupyter) erstellt. Sie können stattdessen auch das Quellformat verwenden.

Sie können Notizbücher weiterhin in verschiedenen Formaten importieren und exportieren. Siehe Importieren und Exportieren von Databricks-Notizbüchern.

Notebookformate

Databricks unterstützt das Erstellen und Bearbeiten von Notizbüchern in zwei Formaten: IPYNB (Standard) und Quelle.

Sie können Quelldateien, einschließlich Notizbüchern, mithilfe von Git-Ordnern verwalten. Nur bestimmte Databricks-Objekttypen werden in Git-Ordnern unterstützt. Das Format wirkt sich darauf aus, wie Notizbücher an Remoterepositorys gebunden werden, wie in der folgenden Tabelle beschrieben.

Notebookquellformat	BESCHREIBUNG
Quelle	Ein einfaches Format, das nur Quellcode erfasst, mit einem Suffix, das die Codesprache signalisiert, wie z. B. .py, .scala, .r und .sql.
IPYNB (Jupyter)	Ein umfangreiches Format, das Quellcode, Notizbuchumgebung, Visualisierungsdefinitionen, Notizbuch-Widgets und optionale Ausgaben erfasst. Ein IPYNB-Notizbuch kann Code in jeder Sprache enthalten, die von Databricks-Notizbüchern unterstützt wird (trotz des py-Teils von .ipynb). Mit dem IPYNB-Format können Sie optional die Versionskontrolle für die Ausgabe eines Notebooks zusammen mit der Versionskontrolle für ein Notebook durchführen.

Das IPYNB-Format unterstützt auch eine bessere Anzeigeerfahrung für Databricks-Notizbücher in Remote-Git-Repositorys. Wenn Sie GitHub oder GitLab verwenden, können Sie Funktionen aktivieren, die Ihnen erweiterte Diffs Ihrer Notizbücher in Pull-Requests bieten, wodurch Sie Änderungen an einem Notizbuch leichter anzeigen und Code-Reviews durchführen können.

Weitere Informationen zur GitHub-Unterstützung für umfangreiche Diff-Dateien von IPYNB-Notebooks finden Sie unter Feature-Vorschau: Umfangreiche Jupyter Notebook-Diff-Dateien. Weitere Informationen zur GitLab-Unterstützung für IPYNB-Notizbuch-Diffs finden Sie unter Jupyter Notebook-Dateien.

Um Quellformatnotizbücher von regulären Python-, Scala- und SQL-Dateien zu unterscheiden, fügt Azure Databricks den Kommentar "Databricks notebook source" am Anfang von Python-, Scala- und SQL-Notizbüchern hinzu. Dieser Kommentar stellt sicher, dass Azure Databricks die Datei ordnungsgemäß als Notizbuch und nicht als Skriptdatei analysiert.

Ändern der Standardeinstellung für das Notizbuchformat

IPYNB-Notizbücher sind das Standardformat beim Erstellen eines neuen Notizbuchs in Azure Databricks.

Um den Standardwert im Azure Databricks-Quellformat zu ändern, melden Sie sich bei Ihrem Azure Databricks-Arbeitsbereich an, klicken Sie oben rechts auf der Seite auf Ihr Profil, und klicken Sie dann auf "Einstellungen ", und navigieren Sie zu "Entwicklertools". Ändern Sie das Standardformat des Notizbuchs unter der Überschrift " Editoreinstellungen" .

Notizbuchformat konvertieren

Sie können ein vorhandenes Notizbuch über die Azure Databricks-Benutzeroberfläche in ein anderes Format konvertieren.

So konvertieren Sie ein vorhandenes Notizbuch in ein anderes Format:

1. Öffnen Sie das Notizbuch in Ihrem Arbeitsbereich.

2. Wählen Sie im Arbeitsbereichsmenü " Datei " aus, wählen Sie " Notizbuchformat" und dann das gewünschte Format aus. Sie können entweder Jupyter (.ipynb) (Empfohlen) oder Quelle (.scala, .py, .sql, .r) auswählen. Das aktuelle Format des Notizbuchs ist ausgegraut und hat ein Häkchen daneben.

   

Weitere Informationen zu den Arten von Notizbüchern, die in Azure Databricks unterstützt werden, finden Sie unter Importieren und Exportieren von Datenbricks-Notizbüchern.

Verwalten von IPYNB-Notebookausgabecommits

Ausgaben sind die Ergebnisse der Ausführung eines Notebooks auf der Databricks-Plattform, einschließlich Tabellenanzeigen und Visualisierungen. Für IPYNB-Notebooks in quellenkontrollierten Ordnern können Sie festlegen, wie Notebookausgaben in das Remote-Repository übertragen werden.

Zulassen von Commits für die Ausgabe von .ipynb-Notebooks

Ausgaben können nur dann committet werden, wenn eine administrierende Person für Arbeitsbereiche diese Funktion aktiviert hat. Standardmäßig ist in den administrativen Einstellungen für Git-Ordner das Committen von .ipynb-Notebookausgaben nicht zulässig. Wenn Sie über Administratorrechte für den Arbeitsbereich verfügen, können Sie diese Einstellung ändern:

1. Wechseln Sie zurArbeitsbereichseinstellungen> für Administratorenin der Azure Databricks-Administratorkonsole.

2. Wählen Sie unter Git-Ordner die Option Git-Ordner zum Exportieren von IPYNB-Ausgaben zulassen und aktivieren Sie anschließend Zulassen: IPYNB-Ausgaben können aktiviert werden.

   

Wichtig

Wenn Ausgaben enthalten sind, sind die Visualisierungs- und Dashboard-Konfigurationen in den .ipynb-Notebooks enthalten, die Sie erstellen.

Steuern von IPYNB-Notebook-Ausgabeartefaktcommits

Wenn Sie eine .ipynb Datei committen, erstellt Databricks eine Konfigurationsdatei, mit der Sie steuern können, wie Ausgaben committet werden: .databricks/commit_outputs.

1. Wenn Sie über eine .ipynb Notizbuchdatei, aber keine Konfigurationsdatei in Ihrem Remote-Repository verfügen, wechseln Sie zum Dialogfeld "Git-Status ".

2. Wählen Sie im Dialogfeld „Benachrichtigung“ die Option commit_outputs-Konfigurationsdatei erstellen aus.

   

Sie können auch Konfigurationsdateien aus dem Menü "Datei " generieren. Das Menü "Datei " verfügt über ein Steuerelement, um die Konfigurationsdatei automatisch zu aktualisieren, in der Sie die Aufnahme oder den Ausschluss von Ausgaben für ein bestimmtes IPYNB-Notizbuch angeben können.

1. Wählen Sie im Datei-Menü die Option Notebookausgaben committen aus.

   

2. Bestätigen Sie im Dialogfeld, dass Sie Notebookausgaben committen möchten.