Importar e exportar notebooks do Databricks

Esta página descreve como importar e exportar blocos de anotações em Azure Databricks e os formatos de bloco de anotações que Azure Databricks dá suporte.

Formatos de notebook compatíveis

O Databricks pode importar e exportar notebooks nos seguintes formatos:

• Arquivo de origem: um arquivo que contém apenas instruções de código-fonte com a extensão .scala, .py, .sql ou .r.
• HTML: um bloco de anotações Azure Databricks com a extensão .html.
• Arquivo .dbc do Databricks.
• Notebook IPython: um Jupyter notebook com a extensão .ipynb.
• RMarkdown: um documento R Markdown com a extensão .Rmd.

Importar um notebook

Você pode importar um notebook externo de uma URL ou um arquivo. Você também pode importar um arquivo ZIP de notebooks exportados em lote de um espaço de trabalho Azure Databricks.

1. Clique no Workspace na barra lateral. Realize um dos seguintes procedimentos:
   • Clique com o botão direito do mouse em uma pasta e selecione Importar.
   • Para importar um bloco de anotações no nível superior da pasta do workspace atual, clique no menu kebab no canto superior direito e selecione Importar.
2. Especifique a URL ou navegue até um arquivo que contém um formato externo com suporte ou um arquivo ZIP de blocos de anotações exportados de um workspace Azure Databricks.
3. Clique em Importar.
   • Se você escolher um único notebook, ele será exportado na pasta atual.
   • Se você escolher um arquivo DBC ou ZIP, sua estrutura de pastas será recriada na pasta atual e cada notebook será importado.

Converter um arquivo em um notebook

Um ativo no workspace é identificado como um notebook se tiver uma extensão .ipynb ou contiver a cadeia de caracteres Databricks notebook source em um comentário na primeira linha e tiver uma das seguintes extensões: .py, .r, .scala, .sql. Qualquer gravação ou renomeação de um bloco de anotações ou arquivo que altera essas condições também altera o tipo do bloco de anotações ou arquivo. Por exemplo, se você tiver um arquivo myfile.txt que tenha # Databricks notebook source como a primeira linha, renomear esse arquivo para myfile.py o transforma em um notebook.

Para converter scripts Python, SQL, Scala e R em notebooks de célula única, adicione um comentário à primeira célula do arquivo:

Python

# Databricks notebook source

SQL

-- Databricks notebook source

Scala (linguagem de programação)

// Databricks notebook source

R

# Databricks notebook source

Para definir células em um script, use o comentário especial mostrado abaixo. Quando você importa o script para o Databricks, as células são criadas conforme marcadas pelas linhas COMMAND mostradas.

Python

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

SQL

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

Scala (linguagem de programação)

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

R

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

Exportar notebooks

Para exportar um bloco de notas:

1. Com o bloco de anotações aberto, clique em Arquivo na barra de ferramentas do bloco de anotações e clique em Exportar....
2. Selecione o tipo de arquivo de exportação no menu de seleção.
3. Se você selecionou bloco de anotações IPython, HTML ou arquivo DBC como o tipo de arquivo de exportação, pode optar por incluir ou não as saídas de célula selecionando ou desmarcando a opção Incluir saídas.
4. Clique em Exportar.

Para exportar todos os notebooks em uma pasta de workspace como um arquivo ZIP:

1. Clique no Workspace na barra lateral.

2. Clique com o botão direito do mouse na pasta e selecione Baixar como.

3. Selecione o formato de download:

   • Arquivo DBC (somente notebooks): Exportar um arquivo DBC do Databricks, um formato binário que inclui metadados e saídas de comando do notebook.
   • Zip – Origem (bloco de anotações + arquivos somente): Exportar um arquivo ZIP de arquivos de origem do bloco de anotações, que pode ser importado para um espaço de trabalho Azure Databricks, usado em um pipeline de CI/CD ou exibido como arquivos de origem no idioma padrão de cada bloco de anotações. As saídas do comando do notebook não estão incluídas.
   • Zip – HTML (somente blocos de anotações): exportar um arquivo ZIP dos blocos de anotações no formato HTML. O arquivo HTML de cada bloco de anotações pode ser importado para um workspace Azure Databricks ou exibido como HTML. As saídas do comando do notebook estão incluídas.