Interface e controles do notebook Databricks

Saiba como usar a barra de ferramentas e os menus do bloco de anotações Databricks para controlar as configurações de exibição do bloco de anotações e da célula.

Células do bloco de notas

Os blocos de notas contêm um conjunto de dois tipos de células: células de código e células de Markdown. As células de código contêm código executável, enquanto as células Markdown contêm código Markdown que processa texto e gráficos. Markdown pode ser usado para documentar ou ilustrar seu código. Pode adicionar ou remove células ao seu bloco de notas para estruturar o seu trabalho.

Você pode executar uma única célula, um grupo de células ou todo o bloco de anotações 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 bloco de anotações

A barra de ferramentas inclui menus e ícones que você pode usar para gerenciar e editar o bloco de anotações.

Ao lado do nome do bloco de anotações estão botões que permitem alterar o idioma padrão do bloco de anotações e, se o bloco de anotações estiver incluído em uma pasta Databricks Git, abra a caixa de diálogo Git.

Para visualizar versões anteriores do bloco de notas, clique no botão "Última edição..." à direita dos menus.

Os ícones e botões à direita da barra de ferramentas são descritos nos seguintes table:

Ícone	Description
	Execute todas as células ou interrompa a execução. O nome deste botão muda dependendo do estado do bloco de notas.
	Abra o seletor de computação. Quando o bloco de anotações está conectado a um cluster ou armazém SQL, esse botão mostra o nome do recurso de computação.
	Agendador de trabalho aberto.
	Abra Delta Live Tables. Esse botão aparecerá somente se o bloco de anotações fizer parte de um pipeline do Delta Live Tables.
	Abra a caixa de diálogo de permissões.

Ações da barra lateral direita

Várias ações estão disponíveis na barra lateral direita do notebook, conforme descrito no seguinte table:

Ícone	Description
	Abra os comentários do bloco de anotações.
	Abra o experimento do bloco de anotações MLflow.
	Abra o histórico de versões do bloco de anotações.
	Abra o explorador de variáveis. (Disponível para variáveis Python com Databricks Runtime 12.2 LTS e superior.)
	Abra o painel Ambiente Python. Este painel mostra todas as bibliotecas Python disponíveis para o bloco de anotações, incluindo bibliotecas com escopo de bloco de anotações, bibliotecas de cluster e bibliotecas incluídas no Databricks Runtime. Disponível apenas quando o bloco de notas está ligado a um cluster.

Criar células

Os blocos de notas têm dois tipos de células: código e Markdown. O conteúdo das células Markdown é processado em HTML. Por exemplo, este trecho 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 Código ou Texto para criar um código ou uma célula Markdown, respectivamente.

Ações da célula

O menu de ações da célula permite executar, cortar e copiar células, mover células no bloco de anotações e ocultar código ou resultados.

Executar uma célula

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 for executada, um aviso aparecerá à 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 mostrar informações detalhadas de execução por padrão, clique na imagem do seu perfil no canto superior direito. Em seguida, clique em >>Mostrar informações detalhadas de execução do comando.

Se você tiver uma saída de resultado tabular, também poderá acessar essas informações passando o mouse sobre a seção "Última atualização" da interface do usuário.

Ícones de célula

A captura de tela a seguir descreve os ícones que aparecem no canto superior direito de uma célula do bloco de anotações:

Seletor de idioma:Select o idioma da célula.

Assistente de Databricks: habilite ou desabilite o Assistente de Databricks para sugestões de código na célula.

Foco da célula: aumente a célula para facilitar a edição.

Exibir menu de ações da célula: abra o menu de ações da 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. Esse í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 de alça de arrastar à esquerda da célula.

Você também pode selectMover para cima ou Mover para baixo no menu de ações da célula.

Recortar, copiar e colar células

Existem várias opções para cortar e copiar células. No entanto, se estiver a utilizar o navegador Safari, apenas os atalhos de teclado estão disponíveis.

• No menu de ações da célula, selectRecortar a célula ou Copiar a célula.
• Use atalhos de teclado: Command-X ou Ctrl-X para cortar e Command-C /ou Ctrl-C copiar.
• Use o menu Editar na parte superior do bloco de anotações. Select Cortar ou Copiar.

Depois de cortar ou copiar células, pode colar essas células noutro local do bloco de notas, num bloco de notas diferente, ou num bloco de notas num separador ou navegador diferente ou window. Para colar células, use o atalho Command-V de teclado ou Ctrl-V. As células são coladas abaixo da célula atual.

Para desfazer ações de cortar ou colar, você pode usar o atalho Command-Z de teclado ou Ctrl-Z as opções do menu Editar > desfazer cortar células ou Editar > desfazer colar células.

Para select células adjacentes, clique numa célula de Marcação e, em seguida, utilize Shift + Up ou Down para select as células acima ou abaixo dela. Use o menu de edição para copiar, cortar, colar ou excluir as células selecionadas como um grupo. Para select todas as células, selectEditar >Select todas as células ou utilize o atalho de modo de comando Cmd+A.

Assistente Open Databricks

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 usá-lo em uma célula de código para get ajuda ou sugestões para seu código. O Assistente de Databricks deve estar habilitado em seu espaço de trabalho.

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 dashboard

Para adicionar uma célula Markdown ou uma célula com resultados tabulares a um dashboard, selectAdicionar ao dashboard no menu de ações da célula. Para obter mais informações, consulte Painéis em blocos de anotações.

Ligar a uma célula

Para get um link para o URL de um comando específico no seu bloco de notas, 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 .

Notebook table de conteúdos

Para exibir um table de conteúdo gerado automaticamente, clique no ícone no canto superior esquerdo do bloco de anotações (entre a barra lateral esquerda e a célula mais acima). A table de conteúdos é gerada a partir dos cabeçalhos Markdown utilizados no bloco de notas. As células com títulos também aparecem na table dos conteúdos.

Adicionar 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.
• Select Adicionar o título a partir do menu de ações da célula .

As células com títulos aparecem na table de conteúdo do bloco de anotações .

Títulos de células promovidas

Para tornar os títulos das células mais visíveis na interface do usuário, os usuários podem habilitar Mostrar títulos de células promovidas.

1. No canto superior direito de qualquer página, clique na sua foto de perfil e, em seguida, clique em Definições.
2. Clique em Ativar desenvolvedor > Mostrar títulos de células promovidas.

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 selectOcultar código ou Ocultar resultado.

Você também pode select recolher a célula para exibir apenas a primeira linha de uma célula. Para expandir uma célula recolhida, selectExpandir célula.

Para mostrar células ocultas, clique no ícone mostrar: .

Cabeçalhos minimizáveis

As células que aparecem após as células que contêm cabeçalhos de Markdown podem ser recolhidas na célula de título. Para expandir ou recolher células após células que contêm cabeçalhos de Markdown em todo o bloco de notas, selectEncerrar todos os cabeçalhos a partir do menu Vista . O restante desta seção descreve como expandir ou recolher um subconjunto de células.

Expandir e recolher cabeçalhos

A imagem mostra uma configuração MLflow de cabeçalho de nível dois com as duas células a seguir recolhidas nela.

Para expandir e recolher cabeçalhos, passe o cursor sobre a célula Markdown. Clique na seta que aparece à esquerda da célula.

Opções de exibição de célula

Existem três opções de visualização para computadores portáteis. Use o menu Exibir 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: as células de código e resultados são exibidas lado a lado.

As ações estão disponíveis a partir de ícones na 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 na calha esquerda. Para excluir uma célula, use o ícone da lixeira na calha direita.

Para facilitar a edição, clique no ícone do modo de foco para exibir a célula em toda a largura. Para sair do modo de foco, clique em . Você também pode aumentar a largura exibida de uma célula desativando > Centrada na Exibição.

Para formatar automaticamente todas as células no bloco de notas, de acordo com os padrões de comprimento de linha e espaçamento da indústria, selectEditar > Formatar o bloco de notas.

Remove margem de célula

Você pode expandir ou minimizar as margens clicando em Exibir > layout do bloco de anotações no menu do bloco de anotações.

Números de linha e comando

Para mostrar ou ocultar números de linha ou números de comando, 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. Quando uma célula está em um estado de erro, os números de linha são exibidos independentemente da seleção.

Se você habilitar números de linha ou comando, o Databricks salvará sua preferência e os mostrará em todos os outros blocos de anotações desse navegador.

Empacotamento de linha

Você pode habilitar ou desabilitar a quebra automática de linha nas células do bloco de anotações, permitindo que o texto seja quebrado em várias linhas ou permaneça em uma única linha com rolagem horizontal.

1. No canto superior direito de qualquer página, clique na sua foto de perfil e, em seguida, clique em Definições.
2. Clique em Configurações do desenvolvedor>Quebrar linhas.

Ver blocos de notas no modo escuro

Você pode optar por exibir blocos de anotações no modo escuro. Para ativar ou desativar o modo escuro, select Ver > Tema e selectTema Luz ou Tema Escuro.

Com números de linha ou comando, o Databricks salva suas preferências e as mostra em seus outros blocos de anotações para esse navegador.

Procurar dados

Para explorar tables e volumes disponíveis para uso no notebook, clique no ícone de dados do notebook no lado esquerdo do notebook para abrir o navegador de schema. Consulte Procurar dados para obter mais detalhes.

Usar terminal web e CLI Databricks

Para abrir o terminal Web num bloco de notas, clique 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 bloco de anotações deve ser conectado a um cluster no modo de acesso compartilhado de usuário único ou sem isolamento.
• A CLI não está disponível em espaços de trabalho habilitados para Link Privado.

A CLI instalada é sempre a versão mais recente. A autenticação é baseada no usuário atual.

Não é possível usar a CLI de uma célula do bloco de anotações. Em um bloco de anotações, comandos como %sh databricks ... não funcionam com o Databricks Runtime 15.0 ou superior.