Interface e controles do notebook do Databricks
A barra de ferramentas do notebook inclui menus e ícones que você pode usar para gerenciar e editar o notebook.
Ao lado do nome do notebook, há botões que permitem alterar o idioma padrão do notebook e, se o notebook estiver incluído em uma pasta Git do Databricks, abrir a caixa de diálogo Git.
Para exibir as versões anteriores do notebook, clique na mensagem "Última edição..." à direita dos menus.
Design de célula atualizado
Importante
Esse recurso está em uma versão prévia.
Um design de célula atualizado está disponível. Essa página inclui informações sobre como usar ambas as versões do design de células. Para obter orientações para a nova interface do usuário e respostas para perguntas comuns, confira Orientações para a nova interface do usuário de células.
Para habilitar ou desabilitar o novo design de célula, abra a página configurações do editor no espaço de trabalho. Na barra lateral, clique em Desenvolvedor. Em Recursos experimentais, alterne a Nova interface do usuário de célula.
Células do notebook
Os notebooks contêm uma coleção de dois tipos de células: células de código e células Markdown. As células de código contém código executável. As células Markdown contêm um código Markdown que é renderizado em texto e gráficos quando a célula é executada e pode ser usado para documentar ou ilustrar seu código. Você pode adicionar ou remover células do seu bloco de notas para estruturar seu trabalho.
Você pode executar uma única célula, um grupo de células ou executar o notebook inteiro de uma só vez. Uma célula de notebook pode conter no máximo 10 MB. A saída da célula do notebook é limitada a 20 MB.
Ícones e botões da barra de ferramentas do notebook
Os ícones e botões à direita da barra de ferramentas estão descritos na seguinte tabela:
| ícone | Descrição |
|---|---|
  |
Executa todas as células ou interrompe a execução. O nome desse botão é alterado dependendo do estado do notebook. |
 |
Abra o seletor de computação. Quando o notebook está conectado a um cluster ou SQL warehouse, esse botão mostra o nome do recurso de computação. |
 |
Abra o agendador de trabalho. |
 |
Abra Delta Live Tables. Esse botão será exibido somente se o notebook fizer parte de um pipeline de Delta Live Tables. |
 |
Abra o diálogo de permissões. |
Ações da barra lateral direita
Há várias ações disponíveis na barra lateral direita do notebook, conforme descrito na seguinte tabela:
| ícone | Descrição |
|---|---|
 |
Abra os comentários do notebook. |
 |
Abra o Experimento de notebook do MLflow. |
 |
Abra o histórico de versões do notebook. |
 |
Abrir o gerenciador de variáveis. (Disponível para variáveis Python com Databricks Runtime 12.2 LTS e versões superiores.) |
 |
Abra o painel do ambiente Python. Esse painel mostra todas as bibliotecas Python disponíveis para o notebook, incluindo bibliotecas com escopo de notebook, bibliotecas de cluster e bibliotecas incluídas no Databricks Runtime. Disponível somente quando o notebook está anexado a um cluster. |
Procurar dados
Importante
Esse recurso está em uma versão prévia.
Para explorar tabelas e volumes disponíveis para uso no notebook, clique no 
do lado esquerdo do notebook para abrir o navegador de esquema. Confira Procurar dados para ver mais detalhes.
Menu de ações de célula
O menu de ações da célula permite cortar e copiar células, migrar células no notebook e ocultar códigos ou resultados. O menu tem uma aparência diferente na interface do usuário original e na nova interface do usuário. Esta seção inclui instruções para ambas as versões.
Se o Assistente do Databricks estiver habilitado em seu espaço de trabalho, você poderá usá-lo em uma célula de código para obter ajuda ou sugestões para o seu código. Para abrir uma caixa de texto do Assistente do Databricks em uma célula, clique no ícone do Assistente do Databricks 
no canto superior direito da célula.
Você pode alterar facilmente uma célula entre código e markdown, ou alterar o idioma de uma célula de código, usando o botão de idioma da célula próximo ao canto superior direito da célula.
Menu de ações da célula (interface do usuário original)
Neste menu, você também pode executar as células de código:
O menu de ação da célula também inclui botões que permitem ocultar uma célula 
ou excluir uma célula 
.
Para células Markdown, há também uma opção para adicionar a célula a um painel. Para obter mais informações, confira os Painéis nos notebooks.
Trabalhar com células na nova interface do usuário
A captura de tela a seguir descreve os ícones que aparecem no canto superior direito da célula de um notebook:
Seletor de idioma: selecione o idioma da célula.
Assistente do Databricks: habilitar ou desabilitar o Assistente do Databricks para sugestões de código na célula.
Foco da célula: amplie a célula para facilitar a edição.
Exibir o menu de ações da célula: abra o menu de ações da célula. As opções desse menu são ligeiramente diferentes para células de código e Markdown.
Para executar células de código na nova interface do usuário, clique na seta para baixo no canto superior esquerdo da célula de código.
Depois que uma célula é executada, um aviso aparece à direita do menu de execução da célula, mostrando a última vez que a célula foi executada e a duração da execução. Passe o cursor sobre o aviso para obter mais detalhes.
Para adicionar uma célula Markdown ou uma célula que tenha resultados tabulares a um painel, selecione Adicionar ao painel no menu de ações da célula. Para obter mais informações, confira os Painéis nos notebooks.
Para excluir uma célula, clique no ícone de lixeira à direita da célula. Esse ícone só aparece quando você passa o cursor sobre a célula.
Para adicionar um comentário ao código em uma célula, realce o código. À direita da célula, aparece um ícone de comentário. Clique no ícone para abrir a caixa de comentários.
Para migrar uma célula para cima ou para baixo, clique e mantenha pressionado 
fora do canto superior esquerdo da célula e arraste-a para o novo local. Você também pode selecionar Migrar para cima ou Migrar para baixo no menu de ações da célula.
Criar células
Os notebooks têm dois tipos de células: código e Markdown. O conteúdo das células Markdown é renderizado em HTML. Por exemplo, este snippet contém marcação para um título de nível um:
%md ### Libraries
Import the necessary libraries.
renderiza como mostrado:
Criar uma célula (interface do usuário original)
Para criar uma nova célula na interface do usuário original, passe o mouse sobre uma célula na parte superior ou inferior e clique no ícone 
. Você também pode usar o menu de célula do notebook: clique no 
e selecione Adicionar célula acima ou Adicionar célula abaixo.
Para uma célula de código, basta digitar código na célula. Para criar uma célula Markdown, selecione Markdown no botão de linguagem da célula ou digite %md na parte superior da célula.
Criar uma célula (nova interface do usuário)
Para criar uma nova célula na nova interface do usuário, passe o mouse sobre uma célula na parte superior ou inferior. Clique em Código ou Texto para criar uma célula Markdown ou de código, respectivamente.
Recortar, copiar e colar células
Há várias opções para cortar e copiar células. Se você estiver usando o navegador Safari, somente os atalhos de teclado estarão disponíveis.
- No menu de ações da célula na interface do usuário original ou na nova interface do usuário, selecione Cortar célula ou Copiar célula.
- Use atalhos de teclado:
Command-XouCtrl-Xpara recortar eCommand-CouCtrl-Cpara copiar. - Use o menu Editar na parte superior do notebook. Selecione Recortar ou Copiar.
Depois de recortar ou copiar células, você pode colar essas células em outro lugar no notebook, em um notebook diferente ou em um notebook em uma guia ou janela diferente do navegador. Para colar células, use o atalho Command-V ou Ctrl-V do teclado. As células são coladas abaixo da célula atual.
Para desfazer as ações de recortar ou colar, você pode usar o atalho de teclado Command-Z ou Ctrl-Z ou as opções de menu Editar > Desfazer células cortadas ou Editar > Desfazer células coladas.
Para selecionar células adjacentes, clique em uma célula Markdown e, em seguida, use Deslocar + Para cima ou Para baixo para selecionar as células acima ou abaixo dela. Use o menu editar para copiar, recortar, colar ou excluir as células selecionadas como um grupo. Para selecionar todas as células, selecione Editar > Selecionar todas as células ou use o atalho do modo de comando CMDmd+A.
Sumário do notebook
Para exibir um sumário gerado automaticamente, clique no ícone no canto superior à esquerda do notebook (entre a barra lateral e a célula superior). O sumário é gerado a partir dos títulos Markdown usados no notebook. Se você estiver usando a nova interface do usuário, as células com títulos também aparecerão no índice.
Opções de exibição de célula
Há três opções de exibição para notebooks. Use o menu Exibição para alterar a opção de exibição.
- Exibição padrão: os resultados são exibidos imediatamente após as células de código.
- Somente resultados: somente os resultados são exibidos.
- Lado a lado: as células de código e os resultados são exibidos lado a lado.
Na nova interface do usuário, as ações estão disponíveis nos ícones da medianiz da célula (a área à direita e à esquerda da célula). Por exemplo, para migrar uma célula para cima ou para baixo, use os pontos de aderência na margem esquerda. Para excluir uma célula, use o ícone da lixeira na janela à direita.
Para facilitar a edição, clique no ícone do modo de foco 
para exibir a célula em largura total. Para sair do modo de foco, clique em 
. Você também pode aumentar a largura exibida de uma célula desativando Exibir > Layout centralizado.
Para formatar automaticamente todas as células do notebook de acordo com o comprimento e o espaçamento das linhas padrão do setor, selecione Editar >. Formatar notebook.
Números de linha e comando
Para mostrar ou ocultar os números de linha ou de comando, selecione Números de linha ou Números de comando no menu Exibir. Nos números de linha, você também pode usar o atalho de teclado Control+L.
Se você habilitar números de linha ou de comando, o Databricks salvará sua preferência e as mostrará em todos os outros notebooks para esse navegador.
Números de linhas e comandos (interface do usuário original)
Os números de comando acima das células vinculam-se a esse comando específico. Se você clicar no número de comando de uma célula, ela atualizará sua URL para ser ancorada nesse comando. Para obter um link de URL para um comando específico no notebook, clique com o botão direito do mouse no número do comando e escolha Copiar Endereço do Link.
Números de linhas e comandos (nova interface do usuário)
Os números de linha estão desativados por padrão na nova interface do usuário. Para ativá-las, selecione Exibir > Números de linha. Quando uma célula está em um estado de erro, os números de linha são exibidos independentemente da seleção.
Para alternar os números de comando, selecione Exibir > Números de comando.
A nova interface do usuário não inclui links de número de comando de célula. Para obter um link de URL para um comando específico em seu notebook, clique em para abrir o modo de foco e copie o URL da barra de endereços do navegador. Para sair do modo de foco, clique em .
Adicionar um título de célula
Para adicionar um título a uma célula usando a interface do usuário original, selecione Mostrar título no menu ações da célula.
Para adicionar um título a uma célula usando a nova interface do usuário, siga um destes procedimentos:
- Clique no número da célula mostrado no centro da parte superior da célula e digite o título.
- Selecione Adicionar título no menu Ações da célula.
Com a nova interface do usuário, as células que têm títulos aparecem no sumário do notebook.
Exibir notebooks no modo escuro
Você pode escolher exibir notebooks no modo escuro. Para ativar ou desativar o modo escuro, selecione Exibir >Tema e selecione Tema Claroou Tema Escuro.
Ocultar e mostrar conteúdo da célula
O conteúdo da célula consiste no código da célula e nos resultados gerados pela execução da célula. Você pode ocultar e exibir o código da célula e o resultado usando o menu de ações da célula no canto superior direito da célula.
Para obter funcionalidades relacionadas, confira Títulos dobráveis.
Ocultar e mostrar o conteúdo da célula (interface do usuário original)
Para ocultar o código da célula ou os resultados, clique em e selecione Ocultar Código ou Ocultar Resultado. Você também pode selecionar para exibir apenas a primeira linha de uma célula.
Para mostrar os resultados ou o código de célula oculto, clique nos links Mostrar:
Ocultar e mostrar o conteúdo da célula (nova interface do usuário)
Para ocultar o código da célula ou os resultados, clique no menu kebab 
no canto superior direito da célula e selecione Ocultar código ou Ocultar resultado. Você também pode selecionar Recolher Célula para exibir apenas a primeira linha de uma célula. Para expandir uma célula recolhida, selecione Expandir célula.
Para mostrar o código ou os resultados da célula oculta, clique no ícone de exibição: 
.
Títulos recolhíveis
As células que aparecem após células contendo títulos Markdown podem ser recolhidas na célula de título. Para expandir ou recolher células após células contendo títulos de Markdown em todo o notebook, selecione Recolher todos os títulos no menu Exibir. O restante desta seção descreve como expandir ou recolher um subconjunto de células.
Para obter funcionalidades relacionadas, confira Ocultar e mostrar o conteúdo da célula.
Expandir e recolher cabeçalhos (interface do usuário original)
A imagem mostra um cabeçalho de nível dois instalação do MLflow com as duas células seguintes recolhidas nele.
Para expandir e recolher os títulos, clique em + e -.
Expandir e recolher títulos (nova interface do usuário)
A imagem mostra um cabeçalho de nível dois instalação do MLflow com as duas células seguintes recolhidas nele.
Para expandir e recolher títulos, passe o cursor sobre a célula Markdown. Clique na seta que aparece à esquerda da célula.
Recursos de computação para notebooks
Esta seção aborda as opções de recursos de computação para notebooks. Você pode executar um notebook em um cluster do Databricks ou, para comandos SQL, você também tem a opção de usar um SQL warehouse, um tipo de computação otimizado para análise de SQL.
Anexe um notebook a um cluster
Para anexar um notebook a um cluster, você precisa da permissão CAN ATTACH TO em nível de cluster.
Importante
Desde que um notebook esteja anexado a um cluster, qualquer usuário com a permissão CAN RUN no notebook tem uma permissão implícita para acessar o cluster.
Para anexar um notebook a um cluster, clique no seletor de computação na barra de ferramentas do notebook e selecione um cluster no menu suspenso.
O menu mostra uma seleção de clusters usados recentemente ou que estão em execução no momento.
Para selecionar entre todos os clusters disponíveis, clique em Mais.... Clique no nome do cluster para exibir um menu suspenso e selecione um cluster existente.
Você também pode criar um cluster selecionando Criar recurso... no menu suspenso.
Importante
Um bloco de anotações anexado tem as seguintes variáveis do Apache Spark definidas.
| Classe | Nome de variável |
|---|---|
SparkContext |
sc |
SQLContext/HiveContext |
sqlContext |
SparkSession (Spark 2.x) |
spark |
Não criar um SparkSession, SparkContextou SQLContext. Isso resultará em um comportamento inconsistente.
Usar um notebook com um SQL warehouse
Quando um notebook é anexado a um SQL warehouse, você pode executar células SQL e Markdown. Executar uma célula em qualquer outra linguagem (como Python ou R) irá gerar um erro. As células SQL executadas em um SQL warehouse aparecem no histórico de consultas do SQL warehouse. O usuário que executou uma consulta pode exibir o perfil de consulta do notebook clicando no tempo decorrido na parte inferior da saída.
A execução de um notebook requer um SQL warehouse pro ou sem servidor. Você deve ter acesso ao workspace e ao SQL warehouse.
Os widgets funcionam de maneira diferente quando um notebook é anexado a um SQL warehouse. Para obter mais detalhes, confira Usar widgets do Databricks em um SQL warehouse.
Para anexar um notebook a um SQL warehouse, faça o seguinte:
Clique no seletor de computação na barra de ferramentas do notebook. O menu suspenso mostra os recursos de computação que estão em execução no momento ou que você usou recentemente. Os SQL warehouses estão marcados com a
.No menu, selecione um SQL warehouse.
Para ver todos os SQL warehouses disponíveis, selecione Mais... no menu suspenso. Uma caixa de diálogo é exibida mostrando os recursos de computação disponíveis para o notebook. Selecione SQL Warehouse, escolha o warehouse que deseja usar e clique em Anexar.
Você também pode selecionar um SQL warehouse como o recurso de computação para um notebook SQL quando criar um fluxo de trabalho ou um trabalho agendado.
As limitações dos SQL warehouses incluem:
- Quando anexados a um SQL warehouse, os contextos de execução têm um tempo limite ocioso de 8 horas.
- O tamanho máximo para os resultados retornados é de 10.000 linhas ou 2 MB, o que for menor.
Desanexar um notebook
Para desanexar um notebook de um recurso de computação, clique no seletor de computação na barra de ferramentas do notebook e passe o mouse sobre o cluster ou SQL warehouse anexado na lista para exibir um menu lateral. No menu lateral, selecione Desanexar.
Você também pode desanexar blocos de anotações de um cluster usando a guia Notebooks na página de detalhes do cluster.
Quando você desanexa um notebook, o contexto de execução é removido e todos os valores de variáveis computados são apagados do notebook.
Dica
O Azure Databricks recomenda que você desanexe notebooks não utilizados de um cluster. Isso libera espaço de memória no driver.
Usar o terminal da Web e a CLI do Databricks
Para abrir o terminal da Web em um notebook, clique em 
na parte inferior da barra lateral direita.
Usar a CLI do Databricks em um terminal da Web
A partir do Databricks Runtime 15.0, você pode usar a CLI do Databricks a partir do terminal da Web no notebook.
Requisitos
- O notebook precisa ser anexado a um cluster no modo de acesso de Usuário único ou Sem isolamento compartilhado.
- A CLI não está disponível em workspaces habilitados para Link Privado.
A CLI instalada é sempre a versão mais recente. A autenticação é baseada no usuário atual.
Você não pode usar a CLI de uma célula de notebook. Comandos como %sh databricks ... em um notebook não funcionam com o Databricks Runtime 15.0 ou superior.