Importer et exporter des notebooks Databricks

Cette page explique comment importer et exporter des notebooks dans Azure Databricks et les formats de notebooks pris en charge par Azure Databricks.

Formats de notebook pris en charge

Databricks peut importer et exporter des notebooks aux formats suivants :

• Fichier source : fichier contenant uniquement des instructions de code source avec l’extension .scala, .py, .sql ou .r.
• HTML : notebook Azure Databricks avec l’extension .html.
• Archive .dbc Databricks.
• Notebook IPython : notebook Jupyter avec l’extension .ipynb.
• RMarkdown : document R Markdown avec l’extension .Rmd.

Importer un notebook

Vous pouvez importer un notebook externe à partir d’une URL ou d’un fichier. Vous pouvez également importer une archive ZIP des notebooks exportés en bloc à partir d’un espace de travail Azure Databricks.

1. Cliquez sur Espace de travail dans la barre latérale. Effectuez l’une des actions suivantes :
   • Cliquez avec le bouton droit de la souris sur un dossier, puis sélectionnez Importer.
   • Pour importer un notebook au niveau supérieur du dossier de l’espace de travail actif, cliquez sur le menu des trois points en haut à droite, puis sélectionnez Importer.
2. Spécifiez l’URL ou accédez à un fichier contenant un format externe pris en charge ou une archive ZIP des notebooks exportés à partir d’un espace de travail Azure Databricks.
3. Cliquez sur Importer.
   • Si vous choisissez un seul notebook, il est exporté dans le dossier actuel.
   • Si vous choisissez une archive DBC ou ZIP, sa structure de dossiers est recréée dans le dossier actuel et chaque notebook est importé.

Convertir un fichier en bloc-notes

Une ressource dans l’espace de travail est identifiée comme un bloc-notes s’il a une .ipynb extension, ou contient la chaîne Databricks notebook source dans un commentaire dans la première ligne et a l’une des extensions suivantes : .py, , .r, .scala.sql. Toute écriture ou renommage d’un bloc-notes ou d’un fichier qui modifie ces conditions change également le type du bloc-notes ou du fichier. Par exemple, si vous avez un fichier myfile.txt qui a # Databricks notebook source comme première ligne, renommer ce fichier en myfile.py le transforme en bloc-notes.

Note

La conversion entre les types de fichiers et de notebooks peut avoir des résultats inattendus, car les notebooks ont un format IPYNB ou source spécifique. Consultez Formats de Notebook.

Pour convertir des scripts Python, SQL, Scala et R en notebooks à cellule unique, ajoutez un commentaire à la première cellule du fichier :

Python

# Databricks notebook source

SQL

-- Databricks notebook source

Langage de programmation Scala

// Databricks notebook source

R

# Databricks notebook source

Pour définir des cellules dans un script, utilisez le commentaire spécial montré ci-dessous. Quand vous importez le script dans Databricks, les cellules sont créées telles qu’elles sont marquées par les lignes COMMAND montrées ici.

Python

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

SQL

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

Langage de programmation Scala

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

R

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

Exporter des carnets de notes

Note

Quand vous exportez un notebook au format HTML, en tant que notebook IPython (.ipynb) ou en tant qu’archive (DBC), et que vous n’avez pas effacé les résultats des commandes, les sorties sont incluses dans l’exportation.

Pour exporter un bloc-notes :

1. Une fois le bloc-notes ouvert, cliquez sur Fichier dans la barre d’outils du bloc-notes, puis sur Exporter....
2. Sélectionnez le type de fichier d’exportation dans le menu déroulant.
3. Si vous avez sélectionné le notebook IPython, HTML ou archive DBC comme type de fichier d’exportation, vous pouvez choisir d’inclure des sorties de cellule ou non en cochant/décochant Inclure les sorties.
4. Cliquez sur Exporter.

Pour exporter tous les blocs-notes dans un dossier d’espace de travail en tant qu’archive ZIP :

1. Cliquez sur Espace de travail dans la barre latérale.

2. Cliquez avec le bouton droit sur le dossier, puis sélectionnez Télécharger en tant que.

3. Sélectionnez le format de téléchargement :

   • Archive DBC (notebooks uniquement) : exportez une archive Databricks, un format binaire qui inclut des métadonnées et des sorties de commande de notebook.
   • Zip - Source (bloc-notes + fichiers uniquement) : exportez une archive ZIP des fichiers sources des bloc-notes, qui peuvent être importés dans un espace de travail Azure Databricks, utilisés dans un pipeline CI/CD ou consultés en tant que fichiers sources dans la langue par défaut de chaque bloc-notes. Les résultats de la commande de notebook ne sont pas inclus.
   • Zip - HTML (notebooks uniquement) : exportez une archive ZIP des blocs-notes au format HTML. Le fichier HTML de chaque bloc-notes peut être importé dans un espace de travail Azure Databricks ou considéré comme HTML. Les résultats de la commande de notebook sont inclus.