Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Por padrão, os notebooks no Databricks são criados no .ipynb formato (IPython ou Jupyter). Você também pode optar por usar o formato original.
Você ainda pode importar e exportar notebooks em vários formatos. Consulte Como importar e exportar notebooks no Databricks.
Formatos de notebook
O Databricks suporta a criação e edição de notebooks em dois formatos: IPYNB (padrão) e código-fonte.
Você pode gerenciar arquivos-fonte, incluindo notebooks, usando repositórios Git. Somente determinados tipos de ativos do Databricks têm suporte em pastas Git. O formato afeta como os notebooks são commitados em repositórios remotos, conforme descrito na tabela abaixo.
| Formato de origem do notebook | Descrição |
|---|---|
| fonte | 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 (Jupyter) | Um formato avançado que captura código-fonte, ambiente de notebook, definições de visualização, widgets de notebook e saídas opcionais. Um notebook IPYNB pode conter código em qualquer idioma compatível com notebooks do Databricks (apesar da parte py de .ipynb). Ao usar o formato IPYNB, opcionalmente, você pode controlar a saída de um notebook junto com o notebook. |
O formato IPYNB também dá suporte a uma melhor experiência de exibição para blocos de anotações do Databricks em repositórios Git remotos. Se você usar o GitHub ou o GitLab, poderá habilitar recursos que oferecem diferenças aprimoradas dos seus notebooks nas solicitações de pull, facilitando a exibição e a revisão de código de alterações em um notebook.
Para saber mais sobre o suporte do GitHub para as versões avançadas de notebooks IPYNB, consulte Visualização de recursos: Difusões ricas do Jupyter Notebook. Para saber mais sobre o suporte do GitLab para diferenças de notebook IPYNB, consulte Arquivos do Jupyter Notebook.
Para distinguir os blocos de anotações de formato de origem dos arquivos Python, Scala e SQL regulares, o Azure Databricks adiciona o comentário “Databricks notebook source” à parte superior dos notebooks Python, Scala e SQL. Esse comentário garante que Azure Databricks analisa corretamente o arquivo como um notebook em vez de um arquivo de script.
Alterar a configuração de formato padrão do notebook
Os notebooks IPYNB são o formato padrão ao criar um novo notebook no Azure Databricks.
Para alterar o padrão para o formato de origem do Azure Databricks, faça login na página inicial do Azure Databricks, clique no seu perfil no canto superior direito da página, clique em Settings e navegue até Developer. Altere o formato padrão do notebook nas configurações do Editor.
Converter o formato do notebook
Você pode converter um notebook existente em outro formato por meio da interface do usuário do Azure Databricks.
Para converter um notebook existente em outro formato:
Abra o bloco de anotações em sua área de trabalho.
Selecione Arquivo no menu do workspace, selecione o formato do Notebook e escolha o formato desejado. Você pode escolher Jupyter (.ipynb) (Recomendado) ou Origem (.scala, .py, .sql, .r). O formato atual do notebook está acinzentado e tem uma marca de seleção ao lado dele.
Para obter mais informações sobre os tipos de notebooks com suporte no Azure Databricks, consulte Importar e exportar notebooks do Databricks.
Gerenciar confirmações de saída do notebook IPYNB
As saídas são os resultados da execução de um notebook na plataforma Databricks, incluindo exibições de tabela e visualizações. Quanto aos notebooks IPYNB nas pastas controladas pelo código-fonte, você pode gerenciar como as saídas do notebook são confirmadas no repositório remoto.
Permitir a confirmação da saída do notebook .ipynb
As saídas só poderão ser confirmadas se um administrador de workspace tiver habilitado esse recurso. Por padrão, a configuração administrativa das pastas Git não permite que a saída do notebook .ipynb seja confirmada. Se você tiver privilégios de administrador para o workspace, poderá alterar essa configuração:
Clique no seu nome de usuário na barra superior do workspace do Azure Databricks e selecione Configurações.
Em administrador do espaço de trabalho, clique em Desenvolvimento.
Na seção Repos, defina Permitir que repos exportem saídas IPYNB para Permitir: As saídas IPYNB podem ser ativadas.
Importante
Quando as saídas são incluídas, as configurações de visualização e painel são incluídas nos notebooks.ipynb que você cria.
Confirmações do artefato de saída do notebook IPYNB de controle
O .databricks/commit_outputs arquivo de configuração no seu repositório controla quais .ipynb saídas do notebook são incluídas no commit. Depois que um administrador de workspace permite commits de saída, você pode criar este arquivo a partir do diálogo Git:
Abra o diálogo Git para uma pasta Git que contenha um
.ipynbnotebook, mas nenhum arquivo.databricks/commit_outputs.No alerta de informações no topo do diálogo, clique em Criar arquivo de configuração commit_outputs.
Você também pode usar o menu Arquivo para incluir ou excluir saídas de um notebook IPYNB específico. Se o arquivo de configuração não existir, o Azure Databricks o cria quando você faz sua seleção. Use essa opção se você descartou o alerta no diálogo do Git.
No menu Arquivo, selecione Confirmar saídas do notebook. O item do menu está disponível apenas para notebooks IPYNB em uma pasta Git, após um administrador do workspace permitir commits de saída.
No diálogo Configuração de commit de saídas, selecione Incluir Saídas ou Excluir Saídas e então clique em Alterar.
