Gerir o formato do bloco de notas

Esta página descreve o formato padrão de caderno no Azure Databricks, como alterar o formato do seu caderno e como gerir os commits de saída se o seu caderno estiver numa pasta controlada por código-fonte.

Por padrão, os blocos de anotações no Databricks são criados no formato .ipynb (IPython ou Jupyter). Você também pode optar por usar o formato de origem.

Você ainda pode importar e exportar blocos de anotações em vários formatos. Consulte Importar e exportar blocos de anotações Databricks.

Formatos de portátil

O Databricks suporta a criação e edição de blocos de anotações em dois formatos: IPYNB (padrão) e source.

Você pode gerir arquivos de origem, incluindo blocos de notas, usando pastas Git. Apenas determinados tipos de ativos Databricks são suportados nas pastas Git. O formato afeta como os notebooks são submetidos a repositórios remotos, conforme descrito na tabela abaixo.

Formato de origem do bloco de notas	Descrição
origem	Um formato básico que captura apenas o código-fonte, com um sufixo que sinaliza a linguagem de código, como .py, .scala, .r e .sql.
IPYNB (Júpiter)	Um formato avançado que captura código-fonte, ambiente de bloco de anotações, definições de visualização, widgets de bloco de anotações e saídas opcionais. Um notebook IPYNB pode conter código em qualquer idioma suportado pelos notebooks Databricks (apesar da parte py do .ipynb). Usando o formato IPYNB, você pode, opcionalmente, controlar a versão da saída de um notebook junto com o notebook.

O formato IPYNB também suporta uma melhor experiência de visualização para notebooks Databricks em repositórios Git remotos. Se usares GitHub ou GitLab, podes ativar funcionalidades que te dão diferenças melhoradas dos teus cadernos em pull requests, facilitando a visualização e revisão de código de alterações num caderno.

Para saber mais sobre o suporte do GitHub para comparações detalhadas de notebooks IPYNB, consulte Feature Preview: Rich Jupyter Notebook Diffs. Para saber mais sobre o suporte do GitLab para diffs de notebooks IPYNB, veja ficheiros Jupyter Notebook.

Para distinguir os notebooks em formato de origem dos ficheiros normais de Python, Scala e SQL, Azure Databricks acrescenta o comentário "Databricks notebook source" no topo dos notebooks Python, Scala e SQL. Este comentário garante que o Azure Databricks analisa corretamente o ficheiro como um caderno em vez de um ficheiro de script.

Alterar a configuração padrão de formato do bloco de anotações

Os notebooks IPYNB são o formato padrão ao criar um novo notebook no Azure Databricks.

Para alterar o formato padrão para o formato de origem do Azure Databricks, inicie sessão no espaço de trabalho do Azure Databricks, clique no seu perfil no canto superior direito da página, depois clique em Definições e navegue até Programador. Altere o formato padrão do notebook nas definições de Editor sob o cabeçalho .

Converter formato de bloco de notas

Pode converter um caderno existente para outro formato através da interface do Azure Databricks.

Para converter um bloco de notas existente para outro formato:

1. Abra o bloco de notas na sua área de trabalho.

2. Selecione Arquivo no menu do espaço de trabalho, selecione Formato do bloco de anotações e escolha o formato desejado. Você pode escolher Jupyter (.ipynb) (Recomendado) ou Source (.scala, .py, .sql, .r). O formato atual do bloco de notas está a cinzento e tem uma marca de verificação ao lado.

   

Para mais informações sobre os tipos de cadernos suportados em Azure Databricks, veja Importar e exportar cadernos Databricks.

Gerenciar confirmações de saída de notebook IPYNB

As saídas são os resultados da execução de um bloco de anotações na plataforma Databricks, incluindo exibições de tabelas e visualizações. Para notebooks IPYNB em pastas controladas por controlo de versão, pode gerir como os resultados do notebook são enviados para o repositório remoto.

Permitir a confirmação da saída do .ipynb notebook

As saídas só podem ser confirmadas se um administrador de espaço de trabalho tiver ativado esse recurso. Por padrão, a configuração administrativa para pastas Git não permite que .ipynb saída do bloco de anotações seja confirmada. Se você tiver privilégios de administrador para o espaço de trabalho, poderá alterar esta configuração:

1. Vai a Admin settings>Workspace settings na consola de administrador do Azure Databricks.

2. Em pastas Git, escolha Permitir que pastas Git exportem saídas IPYNB e, em seguida, selecione Permitir: as saídas IPYNB podem ser ativadas.

   

Importante

Quando as saídas são incluídas, as configurações de visualização e do painel são incorporadas nos cadernos.ipynb que criar.

Gerir os artefatos gerados de saída dos commits do notebook IPYNB

Quando você confirma um arquivo .ipynb, o Databricks cria um arquivo de configuração que permite controlar como você confirma saídas: .databricks/commit_outputs.

1. Se tiveres um arquivo de notebook .ipynb, mas nenhum arquivo de configuração no teu repositório remoto, vai para a caixa de diálogo Git Status.

2. Na caixa de diálogo de notificação, selecione Criar arquivo de configuração commit_outputs.

   

Você também pode gerar arquivos de configuração a partir do menu File. O menu File tem um controle para atualizar automaticamente o arquivo de configuração, onde você pode especificar a inclusão ou exclusão de saídas para um notebook IPYNB específico.

1. No menu Arquivo, selecione Confirmar resultados dos blocos de notas.

   

2. Na caixa de diálogo, confirme a sua escolha para submeter as saídas do notebook.