Amazon
Web Services
Microsoft Azure
Google Cloud PlatformInterface 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 Notebook há botões que permitem que o senhor altere o idioma padrão do Notebook e, se o Notebook estiver incluído em uma pasta Git do Databricks, abra a caixa de diálogo Git.
Para view as versões anteriores do Notebook, clique na mensagem “Última edição…” à direita dos menus.
Design de célula atualizado
Visualização
Este recurso está em Visualização Pública.
Um design de célula atualizado está disponível. Esta página inclui informações sobre como usar as duas versões do design da célula. Para obter uma orientação sobre a nova UI e respostas a perguntas comuns, consulte Orientação para a nova UI de células.
Para ativar ou desativar o novo design de célula, abra a página de configurações do editor na workspace. Na barra lateral, clique em Desenvolvedor. Em Recurso Experimental, alterne Nova UI de célula.
Células Notebook
O notebook 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 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 Notebook para estruturar seu trabalho.
Você pode executar uma única célula, um grupo de células ou executar o notebook inteiro de uma vez. Uma célula de notebook pode conter no máximo 10MB. A saída da célula do caderno de notas é limitada a 20MB.
Ícones e botões da barra de ferramentas do notebook
Os ícones e botões à direita da barra de ferramentas são descritos na tabela a seguir:
Ícone |
Descrição |
|---|---|
|
Execute todas as células ou pare a execução. O nome deste botão muda dependendo do estado do notebook. |
|
Abra o seletorcompute . Quando o Notebook está conectado a clusters ou SQL warehouse, este botão mostra o nome do recurso compute . |
|
Abrir o programador de tarefas. |
|
Abrir o Delta Live Tables. Esse botão aparece somente se o notebook fizer parte de um pipeline do Delta Live Tables. |
|
Ações da barra lateral direita
Várias ações estão disponíveis na barra lateral direita do notebook, conforme descrito na tabela a seguir:
Ícone |
Descrição |
|---|---|
|
Abra os comentáriosNotebook . |
|
|
|
|
|
Abra o explorador de variáveis. (Disponível para as variáveis Python com Databricks Runtime 12.2 LTS e acima.) |
|
Abra o painel de ambiente do Python. Este painel mostra todas as bibliotecas disponíveis no Python 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 estiver anexado a um agrupamento. |
Procurar dados
Visualização
Este recurso está em Visualização Pública.
Para explorar tabelas e volumes disponíveis para uso no Notebook, clique em 
no lado esquerdo do Notebook para abrir o navegador de esquema. Consulte Procurar dados para obter mais detalhes.
Menu de ações de célula
O menu de ações de células permite cortar e copiar células, mover células no Notebook e ocultar códigos ou resultados. O menu tem uma aparência diferente na IU original e na nova IU. Esta seção inclui instruções para ambas as versões.
Se o Databricks Assistant estiver habilitado em seu workspace, você poderá usá-lo em uma célula de código para obter ajuda ou sugestões para seu código. Para abrir uma caixa de texto do Databricks Assistant em uma célula, clique no ícone do Databricks Assistant 
no canto superior direito da célula.
Você pode alterar facilmente uma célula entre código e redução 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 (IU original)
Neste menu, você também pode executar 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 exclua uma célula 
.
Para células Markdown, também existe a opção de adicionar a célula a um painel. Para obter mais informações, consulte Painéis no Notebook.
Trabalhe com células na nova IU
A captura de tela a seguir descreve os ícones que aparecem no canto superior direito de uma célula Notebook :
Seletor de idioma: selecione o idioma da célula.
Assistente do Databricks: habilite ou desabilite o Assistente do Databricks para sugestões de código na célula.
Foco na célula: Amplie a célula para facilitar a edição.
Exibir menu de ações de célula: Abra o menu de ações de célula. As opções neste menu são ligeiramente diferentes para células de código e Markdown.
Para executar células de código na nova IU, clique na seta para baixo no canto superior esquerdo da célula de código.
Após a execução de uma célula, 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, consulte Painéis no Notebook.
Para excluir uma célula, clique no ícone da lixeira à direita da célula. Este í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 mover uma célula para cima ou para baixo, clique e segure 
fora do canto superior esquerdo da célula e arraste a célula para o novo local. Você também pode selecionar Mover para cima ou Mover para baixo no menu de ações da célula.
Criar células
O notebook possui 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 conforme mostrado:
Crie uma célula (IU original)
Para criar uma nova célula na IU original, passe o mouse sobre uma célula na parte superior ou inferior e clique no botão 
ícone. Você também pode usar o menu da célula Notebook : clique em 
e selecione Adicionar célula acima ou Adicionar célula abaixo.
Para uma célula de código, basta digitar o 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.
Recortar, copiar e colar células
Existem várias opções para recortar e copiar células. Se você estiver usando o navegador Safari, apenas os atalhos de teclado estarão disponíveis.
No menu de ações da célula na IU original ou na nova IU, 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.
Após recortar ou copiar células, você pode colar essas células em outro local no notebook, em um notebook diferente ou em um notebook em outra guia ou janela do navegador.Para colar células, utilize o atalho de teclado Command-V ou Ctrl-V. As células são coladas abaixo da célula atual.
Para desfazer 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 cortar células ou Editar > Desfazer colar células.
Para selecionar células adjacentes, clique em uma célula Markdown e, em seguida, use Shift + Cima ou Baixo para selecionar as células acima ou abaixo dela. Utilize 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 Cmd+A.
Índice do notebook
Para exibir um índice gerado automaticamente, clique no ícone no canto superior esquerdo do Notebook (entre a barra lateral esquerda e a célula superior). O índice é gerado a partir dos títulos Markdown usados no Notebook. Se você estiver usando a nova IU, as células com títulos também aparecerão no índice.
Opções de exibição de células
Existem três opções de exibição para Notebook. Use o menu view para alterar a opção de exibição.
Visualizaçã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: códigos e células de resultados são exibidos lado a lado.
Na nova IU, as ações estão disponíveis nos ícones na medianiz da célula (a área à direita e à esquerda da célula). Por exemplo, para mover uma célula para cima ou para baixo, use os pontos de aderência na sarjeta esquerda. Para excluir uma célula, use o ícone da lixeira na medianiz direita.
Para uma edição mais fácil, 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 ampliar a largura exibida de uma célula desativando view > Provisão centralizada.
Para formatar automaticamente todas as células do Notebook de acordo com comprimentos e espaçamentos de linha padrão da indústria, selecione Editar > Formatar Notebook.
Números de linha e comando
Para mostrar ou ocultar números de linha ou números de comando, selecione Números de linha ou Números de comando no menu Exibir. Para números de linha, você também pode usar o atalho de teclado Control+L.
Para exibir uma tabela de conteúdos gerada automaticamente, clique no ícone no canto superior esquerdo do caderno (entre a barra lateral esquerda e a célula superior).
Números de linha e comando (IU original)
Os números dos comandos acima das células estão vinculados a esse comando específico. Se você clicar no número do comando de uma célula, seu URL será atualizado para ser ancorado nesse comando. Para obter um link de URL para um comando específico em seu Notebook, clique com o botão direito no número do comando e escolha Copiar endereço do link.
Números de linha e comando (nova UI)
Os números de linha estão desativados por default na nova IU. Para ativá-los, selecione view > Números de linha. Quando uma célula está em estado de erro, os números das linhas são exibidos independentemente da seleção.
Para alternar os números de comando, selecione view > Command numbers (Números de comando).
A nova UI 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ço do navegador. Para sair do modo de foco, clique em .
Adicione um título de célula
Para adicionar um título a uma célula usando a IU original, selecione Mostrar título no menu de ações da célula.
Para adicionar um título a uma célula usando a nova IU, 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 Add title (Adicionar título ) no menu de ações da célula.
Com a nova IU, as células que possuem títulos aparecem no índice doNotebook.
Visualizar cadernos no modo escuro
Você pode optar por exibir cadernos no modo escuro. Para ativar ou desativar o modo escuro, selecione Visualizar > Tema e selecione Tema claro ou Tema escuro.
Ocultar e mostrar o 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 mostrar o código e o resultado da célula usando o menu de ações da célula no canto superior direito da célula.
Para funcionalidades relacionadas, consulte Títulos recolhíveis.
Ocultar e mostrar o conteúdo da célula (IU original)
Para ocultar o código ou os resultados da célula, 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 o código de célula oculto ou os resultados, clique em Mostrar links:
Ocultar e mostrar o conteúdo da célula (nova UI)
Para ocultar o código ou os resultados da célula, 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 resultados de células ocultas, clique no ícone mostrar: 
.
Títulos expansíveis
As células que aparecem após as células que contêm 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 Markdown em todo o Notebook, selecione Recolher todos os títulos no menu view . O restante desta seção descreve como expandir ou recolher um subconjunto de células.
Para funcionalidades relacionadas, consulte Ocultar e mostrar o conteúdo da célula.
Recursos de computação para blocos de anotações
Esta seção aborda as opções para recursos de computação do notebook. Você pode executar um notebook em um cluster do Databricks ou, para comandos SQL, você também tem a opção de usar um depósito SQL, um tipo de computação que é otimizado para análise SQL.
Anexe um notebook a um cluster
Para anexar um Notebook a um cluster, o senhor precisa da permissão CAN ATTACH TO clusters-level.
Importante
Enquanto o site Notebook estiver conectado a um cluster, qualquer usuário com a permissão de execução do CAN no site Notebook terá permissão implícita para acessar os clusters.
Para anexar um Notebook a clusters, clique no seletor de computação na barra de ferramentas Notebook e selecione um clusters no menu dropdown .
O menu mostra uma seleção de clusters que você usou recentemente ou que estão em execução no momento.
Para selecionar 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 novo cluster selecionando Criar novo recurso... no menu dropdown.
Importante
Um bloco de anotações anexado tem as seguintes variáveis do Apache Spark definidas.
Aula |
Nome da variável |
|---|---|
|
|
|
|
|
|
Não crie um SparkSession, SparkContext, ou SQLContext. Fazer isso levará a um comportamento inconsistente.
Usar um notebook com um SQL warehouse
Quando um Notebook é anexado a um SQL warehouse, o senhor pode executar células SQL e Markdown. A execução de uma célula em qualquer outra linguagem (como Python ou R) gera um erro. As células SQL executadas em um SQL warehouse aparecem no histórico de consultas doSQL warehouse. O usuário que executa uma consulta pode view o perfil da consulta no site Notebook clicando no tempo decorrido na parte inferior da saída.
A execução de um Notebook requer um Pro ou serverless SQL warehouse. O senhor deve ter acesso ao workspace e ao SQL warehouse.
Os widgets funcionam de forma diferente quando um Notebook é anexado a um SQL warehouse. Para obter detalhes, consulte Usar widgets do Databricks em um site SQL warehouse.
Para anexar um notebook a um SQL warehouse, faça o seguinte:
Clique no seletorcompute na barra de ferramentas Notebook . O menu dropdown mostra os recursos compute que estão em execução ou que você usou recentemente. SQL warehouse são marcados com
.No menu, selecione um SQL warehouse.
Para ver todos os SQL warehouse disponíveis, selecione Mais… no menu dropdown. Uma caixa de diálogo aparece mostrando os recursos de computação disponíveis para o notebook. Selecione SQL warehouse, escolha o armazém que deseja usar e clique em Anexar.
O senhor também pode selecionar um SQL warehouse como o recurso compute para um SQL Notebook ao criar um fluxo de trabalho ou um agendamento Job.
As limitações dos SQL warehouses incluem:
Quando anexado a um SQL warehouse, os contextos de execução têm um tempo limite ocioso de 8 horas.
O tamanho máximo para resultados retornados é de 10.000 linhas ou 2 MB, o que for menor.
Desanexar um notebbok
Para desvincular um notebbok de um recurso de computação, clique no seletor de computação na barra de ferramentas do notebook e passe o cursor sobre o cluster ou o SQL warehouse vinculado na lista para exibir um menu lateral.No menu lateral, selecione Detectar.
Você também pode desanexar notebooks 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 computadas são apagados do notebook.
Dica
O Databricks recomenda que você desanexe notebooks não utilizados de clusters. Isto liberta 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 site Notebook, clique em 
na parte inferior da barra lateral direita.
Use o Databricks CLI em um terminal da Web
A partir do Databricks Runtime 15.0, o senhor pode usar a CLI do Databricks a partir do terminal da Web no site Notebook.
Requisitos
O Notebook deve estar conectado a um cluster no modo de acesso compartilhado Single user ou No isolation.
A CLI não está disponível no espaço de trabalho habilitado para o PrivateLink.
A CLI instalada é sempre a versão mais recente. A autenticação é baseada no usuário atual.
O senhor não pode usar a CLI em uma célula Notebook. comandos como %sh databricks ... em um Notebook não funcionam com o Databricks Runtime 15.0 ou acima.
