Importieren und Exportieren von Databricks-Notizbüchern

Diese Seite beschreibt, wie Notebooks in Azure Databricks importiert und exportiert werden und welche Notebookformate von Azure Databricks unterstützt werden.

Unterstützte Notebookformate

Databricks kann Notebooks in den folgenden Formaten im- und exportieren:

• Quelldatei: Eine Datei, die nur Quellcodeanweisungen mit der Erweiterung .scala, .py, .sql oder .r enthält.
• HTML: Ein Azure Databricks-Notebook mit der Erweiterung .html.
• Databricks-Archiv (.dbc).
• IPython-Notebook: Ein Jupyter Notebook mit der Erweiterung .ipynb.
• RMarkdown: Ein R Markdown-Dokument mit der Erweiterung .Rmd.

Importieren eines Notizbuchs

Sie können ein externes Notebook aus einer URL oder einer Datei importieren. Sie können auch ein ZIP-Archiv von Notebooks importieren, die in einem Massenvorgang aus einem Azure Databricks-Arbeitsbereich exportiert wurden.

1. Klicken Sie auf Arbeitsbereich in der Randleiste. Führen Sie eines der folgenden Verfahren aus:
   • Klicken Sie mit der rechten Maustaste auf einen Ordner, und wählen Sie Importieren aus.
   • Um ein Notebook auf der obersten Ebene des aktuellen Arbeitsbereichsordners zu importieren, klicken Sie oben rechts auf das Optionsmenü und wählen Importieren aus.
2. Geben Sie die URL an, oder navigieren Sie zu einer Datei, die ein unterstütztes externes Format oder ein ZIP-Archiv von Notebooks enthält, die aus einem Azure Databricks-Arbeitsbereich exportiert wurden.
3. Klicken Sie auf Importieren.
   • Wenn Sie ein einzelnes Notebook auswählen, wird es im aktuellen Ordner exportiert.
   • Wenn Sie ein DBC- oder ZIP-Archiv auswählen, wird dessen Ordnerstruktur im aktuellen Ordner neu erstellt, und jedes Notebook wird importiert.

Konvertieren einer Datei in ein Notizbuch

Ein Objekt im Arbeitsbereich wird als Notizbuch identifiziert, wenn es eine .ipynb Erweiterung hat, oder die Zeichenfolge Databricks notebook source in einem Kommentar in der ersten Zeile enthält und eine der folgenden Erweiterungen aufweist: .py, .r, .scala, .sql. Jedes Schreiben oder Umbenennen eines Notizbuchs oder einer Datei, das diese Bedingungen ändert, ändert auch den Typ des Notizbuchs oder der Datei. Wenn Sie beispielsweise eine Datei myfile.txt that has # Databricks notebook source as the first line, renaming that file to myfile.py coverts it into a notebook.

Hinweis

Das Konvertieren zwischen Datei- und Notizbuchtypen kann unerwartete Ergebnisse haben, da Notizbücher ein bestimmtes IPYNB- oder Quellformat aufweisen. Siehe Notizbuchformate.

Um Python-, SQL-, Scala- und R-Skripts in Einzelzellen-Notizbücher zu konvertieren, fügen Sie der ersten Zelle der Datei einen Kommentar hinzu:

Python

# Databricks notebook source

SQL

-- Databricks notebook source

Scala

// Databricks notebook source

R

# Databricks notebook source

Um Zellen in einem Skript zu definieren, verwenden Sie den unten gezeigten speziellen Kommentar. Wenn Sie das Skript in Databricks importieren, werden Zellen erstellt, die durch die gezeigten COMMAND-Zeilen markiert sind.

Python

# COMMAND ----------

SQL

-- COMMAND ----------

Scala

// COMMAND ----------

R

# COMMAND ----------

Exportieren von Notizbüchern

Hinweis

Wenn Sie ein Notebook als HTML, IPython-Notebook (.ipynb) oder Archiv (DBC) exportieren und die Befehlsausgaben nicht gelöscht haben, werden die Ausgaben in den Export einbezogen.

So exportieren Sie ein Notizbuch:

1. Wenn das Notizbuch geöffnet ist, klicken Sie in der Notizbuchsymbolleiste auf "Datei ", und klicken Sie dann auf "Exportieren...".
2. Wählen Sie den Exportdateityp aus dem Dropdownmenü aus.
3. Wenn Sie IPython-Notizbuch, HTML oder DBC-Archiv als Exportdateityp ausgewählt haben, können Sie festlegen, dass Zellenausgaben eingeschlossen werden sollen oder nicht, indem Sie "Ausgabe einschließen" aktivieren bzw. deaktivieren.
4. Klicken Sie auf Exportieren.

So exportieren Sie alle Notizbücher in einem Arbeitsbereichsordner als ZIP-Archiv:

1. Klicken Sie auf Arbeitsbereich in der Randleiste.

2. Klicken Sie mit der rechten Maustaste auf den Ordner, und wählen Sie "Herunterladen als" aus.

3. Wählen Sie das Downloadformat aus:

   • DBC-Archiv (nur Notizbücher):Exportieren Sie ein Databricks-Archiv, ein Binärformat, das Metadaten- und Notizbuchbefehle enthält.
   • Zip - Quelle (nur Notizbuch + Dateien): Exportieren Eines ZIP-Archivs von Notizbuchquelldateien, die in einen Azure Databricks-Arbeitsbereich importiert werden können, in einer CI/CD-Pipeline verwendet oder als Quelldateien in der Standardsprache jedes Notizbuchs angezeigt werden können. Notebookbefehlsausgaben werden nicht einbezogen.
   • Zip - HTML (nur Notizbücher):Exportieren Sie ein ZIP-Archiv der Notizbücher im HTML-Format. Die HTML-Datei jedes Notizbuchs kann in einen Azure Databricks-Arbeitsbereich importiert oder als HTML angezeigt werden. Notebookbefehlsausgaben werden einbezogen.