Aller au contenu principal

Importation et exportation des Notebooks Databricks

Databricks peut importer et exporter des notebooks dans plusieurs formats, convertir des fichiers de script en notebooks et exporter des dossiers entiers sous forme d'archive ZIP.

Formats Notebook pris en charge

Databricks peut importer et exporter des notebooks dans les formats suivants :

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

Importez un Notebook.

Vous pouvez importer un notebook externe à partir d'une URL ou d'un fichier. Vous pouvez également importer une archive ZIP de Notebooks exportés en masse depuis un workspace Databricks.

  1. Cliquez Icône du Notebook. sur **Workspace** dans la barre latérale. Effectuez l'une des opérations suivantes :

    • Faites un clic droit sur un dossier et sélectionnez Importer .
    • Pour importer un notebook au niveau supérieur du dossier Workspace actuel, cliquez sur le menu kebab en haut à droite et sélectionnez « Importation ».
  2. Spécifiez l'URL ou accédez à un fichier contenant un format externe pris en charge ou une archive ZIP de notebooks exportés d'un Workspace 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 Notebook

Un asset dans le Workspace est identifié comme un Notebook s'il a une extension .ipynb, ou contient la chaîne de caractères Databricks notebook source dans un commentaire sur la première ligne et a l'une des extensions suivantes : .py, .r, .scala, .sql. Toute écriture ou renommage d'un Notebook ou d'un fichier qui modifie ces conditions modifie également le type du Notebook ou du fichier. Par exemple, si vous avez un fichier myfile.txt qui contient # Databricks notebook source sur la première ligne, le renommer en myfile.py le convertit en Notebook.

remarque

La conversion entre les types de fichiers et de notebooks peut avoir des résultats inattendus, car les notebooks ont un format spécifique IPYNB ou source. Voir 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

Pour définir des cellules dans un script, utilisez le commentaire spécial présenté ci-dessous. Lorsque vous importez le script dans Databricks, les cellules sont créées telles qu'indiquées par les COMMAND lignes affichées.

Python
# COMMAND ----------

Exporter les Notebook

remarque

Pour exporter un Notebook :

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

Pour exporter tous les notebooks d'un dossier de Workspace en tant qu'archive ZIP :

  1. Cliquez sur Icône du Notebook. Workspace dans la barre latérale.

  2. Faites un clic droit sur le dossier et sélectionnez download as .

  3. Sélectionnez le format download :

    • Archive DBC (Notebooks uniquement) : Exportez une archive Databricks, un format binaire qui inclut les métadonnées et les sorties de commande du notebook.
    • Zip - Source (uniquement Notebook + fichiers) : Exportez une archive ZIP des fichiers source du Notebook, qui peut être importée dans un Workspace Databricks, utilisée dans un pipeline CI/CD, ou visualisée en tant que fichiers source dans la langue default de chaque Notebook. Les sorties de commande du Notebook ne sont pas incluses.
    • Zip - HTML (Notebooks uniquement) : Exportez une archive ZIP des Notebooks au format HTML. Le fichier HTML de chaque Notebook peut être importé dans un Workspace Databricks ou visualisé en tant que fichier HTML. Les sorties de commande du Notebook sont incluses.
remarque

L'archive HTML n'est pas prise en charge dans les Workspace AWS GovCloud.