Amazon
Web Services
Microsoft Azure
Google Cloud PlatformInterface e controles do notebook do Databricks
Saiba como usar a barra de ferramentas e os menus do Databricks Notebook para controlar as configurações de exibição do Notebook e das células.
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, enquanto as células Markdown contêm código Markdown que renderiza texto e gráficos. O Markdown pode ser usado para documentar ou ilustrar seu código. O senhor pode adicionar ou remover células do Notebook para estruturar seu trabalho.
O senhor pode executar uma única célula, um grupo de células ou todo o Notebook de uma só vez. Uma célula de Notebook pode conter no máximo 10 MB e sua saída é limitada a 20 MB.
Ícones e botões da barra de ferramentas do notebook
A barra de ferramentas inclui menus e ícones que o senhor 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.
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 seletor de computação. Quando o Notebook está conectado a um cluster ou SQL warehouse, esse 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 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. |
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:
Para criar uma nova célula, passe o mouse sobre uma célula na parte superior ou inferior. Clique em Code (Código ) ou Text (Texto ) para criar uma célula de código ou Markdown, respectivamente.
Ações celulares
O menu de ações da célula permite que o senhor execute, corte e copie células, mova células no Notebook e oculte códigos ou resultados.
execução a cell
Para executar células de código, 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 sua duração. Passe o cursor sobre o aviso para obter mais detalhes.
Para exibir informações detalhadas de execução em default, clique na imagem de seu perfil no canto superior direito. Em seguida, clique em Settings > Developer > Show detailed comando execution information.
Se o senhor tiver uma saída de resultado tabular, também poderá acessar essas informações passando o mouse sobre a seção "Last refreshed" (Última atualização) da UI.
Ícones de células
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: Ampliar 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.
Excluir uma célula
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.
Mover uma célula
Para mover uma célula para cima ou para baixo, clique e mantenha pressionado o ícone da alça de arrasto 
à esquerda da célula.
O senhor também pode selecionar Mover para cima ou Mover para baixo no menu de ações da célula.
Recortar, copiar e colar células
Há várias opções para cortar e copiar células. No entanto, se o senhor estiver usando o navegador Safari, somente os atalhos de teclado estarão disponíveis.
No menu de ações da célula, selecione Cut cell (Cortar célula ) ou Copy cell (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 cortar ou copiar células, é possível colar essas células em outro local do Notebook, em outro Notebook ou em um Notebook em outro navegador tab ou janela. Para colar células, use 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.
Aberto Databricks Assistant
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.
O senhor pode usá-lo em uma célula de código para obter ajuda ou sugestões para o seu código. Databricks Assistant deve estar ativado em seu site workspace.
Adicionar comentários de código
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.
Adicionar uma célula a um painel
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.
Í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 mais alta). O índice é gerado a partir dos cabeçalhos Markdown usados no Notebook. As células com títulos também aparecem na tabela de conteúdo.
Adicione um título de célula
Para adicionar um título a uma célula, siga um destes procedimentos:
Clique no número da célula 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.
As células com títulos aparecem na tabela de conteúdo do Notebook.
Títulos de células promovidos
Para tornar os títulos das células mais visíveis na interface do usuário, os usuários podem ativar a opção Show promoted cell titles (Mostrar títulos de células promovidas).
No canto superior direito de qualquer página, clique em sua foto de perfil e, em seguida, clique em Settings (Configurações).
Clique em Developer > Enable Show promoted cell titles.
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 da execução da célula. Para ocultar o código da célula ou os resultados, clique no menu kebab 
no canto superior direito da célula e selecione Hide code (Ocultar código ) ou Hide result (Ocultar resultado).
O senhor também pode selecionar Colapsar célula para exibir apenas a primeira linha de uma célula. Para expandir uma célula recolhida, selecione Expandir célula.
Para exibir células ocultas, clique no ícone de exibição: 
.
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.
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.
As ações estão disponíveis nos ícones da calha da célula (a área à direita e à esquerda da célula). Por exemplo, use os pontos de aderência para mover uma célula para cima ou para baixo! Para excluir uma célula, use o ícone da lixeira na janela à 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.
Remover as margens das células
O senhor pode expandir ou minimizar as margens clicando em view > Notebook disposição no menu 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 de visualização. Para números de linha, o senhor também pode usar o atalho de teclado Control+L. Quando uma célula está em um estado de erro, os números de linha são exibidos independentemente da seleção.
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).
Embalagem de linha
O senhor pode ativar ou desativar a quebra de linha nas células do Notebook, permitindo que o texto seja quebrado em várias linhas ou permaneça em uma única linha com rolagem horizontal.
No canto superior direito de qualquer página, clique em sua foto de perfil e, em seguida, clique em Settings (Configurações).
Clique em Configurações do desenvolvedor > Wrap lines.
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.
ble linha ou números de comando, o site Databricks salva sua preferência e a mostra em seu outro Notebook para esse navegador.
Procurar dados
Visualização
Este recurso está em Visualização Pública.
Para explorar as tabelas e os volumes disponíveis para uso no Notebook, clique em 
no lado esquerdo do Notebook para abrir o navegador de esquemas. Consulte Procurar dados para obter mais detalhes.
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 o CLI de uma célula de Notebook. Em um Notebook, comandos como %sh databricks ... não funcionam com Databricks Runtime 15.0 ou acima.