Verwalten des Datenbricks-Notizbuchformats

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, mit denen Sie erweiterte Diffs für Ihre Notizbücher in Pull-Requests erhalten. Dies erleichtert es, Änderungen an einem Notizbuch anzuzeigen und den Code zu überprüfen.

Weitere Informationen zur GitHub-Unterstützung für detaillierte Diffs von IPYNB-Notizbüchern finden Sie unter Feature Preview: Rich Jupyter Notebook Diffs. 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" oben in Python, Scala und SQL-Notizbüchern hinzu. Dieser Kommentar stellt sicher, dass Azure Databricks die Datei nicht als Skriptdatei, sondern als Notizbuch richtig analysiert.

Ändern der Standardeinstellung für das Notizbuchformat

IPYNB-Notizbücher sind das Standardformat beim Erstellen eines neuen Notizbuchs auf 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, klicken Sie dann auf Settings und navigieren Sie zu Developer. Ändern Sie das Standardformat des Notizbuchs unter der Überschrift " Editoreinstellungen" .

Notizbuchformat konvertieren

Sie können ein vorhandenes Notizbuch über die benutzeroberfläche Azure Databricks 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. Klicken Sie in der oberen Leiste des Azure Databricks-Arbeitsbereichs auf Ihren Benutzernamen, und wählen Sie "Einstellungen" aus.

2. Unter Workspace-Admin klicken Sie auf Entwicklung.

3. Im Abschnitt Repos setzen Sie Repos das Exportieren von IPYNB-Ausgaben erlauben auf 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

Die Konfigurationsdatei .databricks/commit_outputs in deinem Repository steuert, welche .ipynb Notebook-Ausgaben committet werden. Nachdem ein Workspace-Admin Output-Commits erlaubt, kannst du diese Datei aus dem Git-Dialog erstellen:

1. Öffne den Git-Dialog für einen Git-Ordner, der ein .ipynb Notebook, aber keine .databricks/commit_outputs Datei enthält.

2. Im Info-Alert oben im Dialog klicke auf commit_outputs Konfigurationsdatei erstellen.

   

Du kannst auch das Dateimenü nutzen, um Ausgaben für ein bestimmtes IPYNB-Notizbuch einzu- oder auszuschließen. Wenn die Konfigurationsdatei nicht existiert, erstellt Azure Databricks sie, wenn du deine Auswahl triffst. Nutze diese Option, wenn du die Warnung im Git-Dialog geschlossen hast.

1. Im Dateimenü wählen Sie Notebook-Ausgaben committen. Das Menüelement ist nur für IPYNB-Notizbücher in einem Git-Ordner verfügbar, nachdem ein Arbeitsbereichsadministrator Ausgabe-Comits erlaubt.

   

2. Im Konfigurationsdialog Commit Outputs wählen Sie Include Outputs oder Outputs ausschließen aus und klicken dann auf Ändern.