Navegue pelo editor de arquivos e notebook do Databricks

Este artigo descreve as funções disponíveis para ajudar você a navegar no notebook e editor de arquivos do Databricks, incluindo atalhos de teclado, sugestões de código e preenchimento automático, inspeção variável e dobragem de código. Quando você usa o notebook ou o editor de arquivos, o Assistente do Databricks está disponível para ajudá-lo a gerar, explicar e depurar código. Confira Obter ajuda de codificação do assistente do Databricks para obter detalhes.

Você pode escolher entre uma seleção de temas do editor. Selecione Exibir > Tema do Editor e faça uma seleção no menu.

Atalhos de teclado

Para exibir atalhos de teclado, selecione Ajuda > Atalhos de teclado. Os atalhos de teclado disponíveis dependem se o cursor está em uma célula de código (modo de edição) ou não (modo de comando).

paleta de comandos

Você pode executar rapidamente ações no notebook usando a paleta de comandos. Para abrir um painel de ações do notebook, clique em no canto inferior direito da área de trabalho ou use o atalho Cmd + Shift + P no MacOS ou Ctrl + Shift + P no Windows.

Localizar e substituir texto

Para localizar e substituir o texto em um caderno, selecione Editar > Localizar e Substituir. A correspondência atual é realçada em laranja e todas as outras correspondências são realçadas em amarelo.

Para substituir a correspondência atual, clique em Substituir. Para substituir todas as correspondências no notebook, clique em Substituir Tudo.

Para alternar entre as correspondências, clique nos botões Prev e Next. Você também pode pressionar SHIFT+ENTER e ENTER para ir às correspondências anteriores e seguintes, respectivamente.

Para fechar a ferramenta localizar e substituir, clique em ou pressione esc.

Inspeção de variável

Para exibir informações sobre uma variável definida em um notebook SQL ou Python, passe o cursor sobre o nome da variável. A inspeção de variável do Python requer o Databricks Runtime 12.2 LTS ou superior.

Confira Gerenciador de Variáveis.

Ir para a definição

Quando um notebook Python é anexado a um cluster, você pode ir rapidamente para a definição de uma variável, função ou o código por trás de uma instrução %run. Para fazer isso, clique com o botão direito do mouse na variável ou no nome da função e clique em Ir para definição ou Espiar definição.

Mantenha pressionada a tecla Cmd no macOS ou a tecla Ctrl no Windows e focalize no nome da variável ou da função. Se uma definição for encontrada, o nome se transformará em um hiperlink.

O recurso “ir para definição” está disponível no Databricks Runtime 12.2 LTS e superior.

Dobramento de código

O dobramento de código permite ocultar temporariamente seções de código. Isso pode ser útil ao trabalhar com blocos de código longos, pois permite que você se concentre em seções específicas do código em que você está trabalhando.

Para ocultar o código, coloque o cursor na extrema esquerda de uma célula. As setas apontando para baixo aparecem em pontos lógicos em que você pode ocultar uma seção de código. Clique na seta para ocultar uma seção de código. Clique na seta novamente (agora apontando para a direita) para mostrar o código.

Para obter mais detalhes, incluindo atalhos de teclado, consulte a documentação do VS Code.

Suporte a multicursor

Você pode criar vários cursores para facilitar as edições simultâneas, conforme mostrado no vídeo:

Para criar vários cursores em uma célula:

• No macOS, mantenha pressionada a tecla Option e clique em cada local para adicionar um cursor.
• No Windows, mantenha pressionada a tecla Alt e clique em cada local para adicionar um cursor.
• Você também tem a opção de alterar o atalho. Confira como Alterar atalho para seleção de coluna e multicursor.

No macOS, é possível criar diversos cursores alinhados verticalmente usando o atalho do teclado Option+Command+ tecla de seta para cima ou para baixo.

Seleção de coluna (caixa)

Para selecionar vários itens em uma coluna, clique no canto superior esquerdo da área que você deseja capturar. Em seguida:

• No macOS, pressione Shift + Option e arraste para o canto inferior direito para capturar uma ou mais colunas.
• No Windows, pressione Shift + Alt e arraste para o canto inferior direito para capturar uma ou mais colunas.
• Você também tem a opção de alterar o atalho. Confira como Alterar atalho para seleção de coluna e multicursor.

Alterar atalho para seleção de coluna e multicursor

Um atalho alternativo está disponível para seleção multicursor e de coluna (caixa). Com a seleção alternativa, os atalhos mudam da seguinte maneira:

• Para criar vários cursores em uma célula:
  • No macOS, mantenha pressionada a tecla Cmd e clique em cada local para adicionar um cursor.
  • No Windows, mantenha pressionada a tecla Ctrl e clique em cada local para adicionar um cursor.
• Para selecionar vários itens em uma coluna, clique no canto superior esquerdo da área que você deseja capturar. Em seguida:
  • No macOS, pressione Option e arraste para o canto inferior direito para capturar uma ou mais colunas.
  • No Windows, pressione Alt e arraste para o canto inferior direito para capturar uma ou mais colunas.

Para habilitar os atalhos alternativos, faça o seguinte:

1. Clique no nome de usuário no canto superior direito do workspace e clique em Configurações na lista suspensa.
2. Na barra lateral Configurações, selecione Desenvolvedor.
3. Na seção Editor de código, altere a configuração Modificador de chave para clique com vários cursores para Cmd para macOS ou Ctrl para Windows.

Quando você habilita atalhos alternativos, o atalho do teclado para criar diversos cursores alinhados verticalmente não muda.

Navegar pelos dados

Use o navegador de esquema para explorar os objetos do Catálogo do Unity disponíveis para o notebook. Clique no ícone de dados do notebook no lado esquerdo do notebook para abrir o navegador de esquema.

O botão For you exibe apenas os objetos que você usou na sessão atual ou marcados anteriormente como Favoritos.

À medida que você digita texto na caixa filtro, a exibição muda para mostrar apenas os objetos que contêm o texto que você digita. Somente os objetos que estão abertos no momento ou abertos na sessão atual são exibidos. A caixa Filtro não faz uma pesquisa completa dos catálogos, esquemas, tabelas e volumes disponíveis para o notebook.

Para abrir o menu menu de kebab, passe o cursor sobre o nome do objeto, conforme mostrado:

Se o objeto for uma tabela, você poderá fazer o seguinte:

• Crie e execute automaticamente uma célula para exibir uma visualização dos dados na tabela. Selecione Pré-visualização em uma nova célula no menu kebab da tabela.
• Exibir um catálogo, esquema ou tabela no Gerenciador de Catálogos. Selecione Abrir no Explorador do Catálogo no menu de kebab. Uma nova guia é aberta mostrando o objeto selecionado.
• Obtenha o caminho para um catálogo, esquema ou tabela. Selecione Copiar … caminho no menu kebab do objeto.
• Adicione uma tabela aos Favoritos. Selecione Adicionar aos favoritos no menu kebab da tabela.

Se o objeto for um catálogo, esquema ou volume, você poderá copiar o caminho do objeto ou abri-lo no Catalog Explorer.

Para inserir um nome de tabela ou coluna diretamente em uma célula:

1. Clique no cursor na célula no local em que você deseja inserir o nome.
2. Mova o cursor sobre o nome da tabela ou o nome da coluna no navegador do esquema.
3. Clique na seta dupla que aparece à direita do nome do objeto.

Usar o terminal web e a CLI do Databricks

Para abrir o terminal web em um notebook, clique em na parte inferior da barra lateral direita.

Usar a CLI do Databricks em um terminal Web

A partir do Databricks Runtime 15.0, você pode usar a CLI do Databricks no 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. Em um notebook, comandos como %sh databricks ... não funcionam com o Databricks Runtime 15.0 ou superior.

Preenchimento automático personalizado

O Preenchimento automático conclui automaticamente segmentos de código à medida que você os digita. Os objetos que podem ser concluídos incluem tipos, classes e objetos, bem como nomes de tabelas e bancos de dados SQL. O Databricks usa os metadados e o uso do Catálogo do Unity para personalizar sugestões.

• Para células Python, o notebook deve ser anexado a um cluster para que o preenchimento automático funcione e você deve executar todas as células que definem objetos completáveis.
• Para células SQL, o preenchimento automático sugere palavras-chave e sintaxe básica, mesmo que o notebook não esteja anexado a nenhum recurso de computação.
  • Se o workspace estiver habilitado para o Catálogo do Unity, o preenchimento automático também sugerirá nomes de catálogo, esquema, tabela e coluna para tabelas no Catálogo do Unity.
  • Se o workspace não estiver habilitado para o Catálogo do Unity, o notebook deverá ser anexado a um cluster ou a um SQL warehouse para sugerir nomes de tabela ou coluna.

As sugestões de preenchimento automático aparecem automaticamente quando você digita em uma célula. Use as teclas de seta para cima e para baixo ou o mouse para selecionar uma sugestão e pressione Tab ou Enter para inserir a seleção na célula.

Há duas configurações de usuário para estar ciente:

• Para desativar sugestões de preenchimento automático, alterne Preenchimento automático conforme você digita. Quando o preenchimento automático estiver desativado, você poderá exibir sugestões de preenchimento automático pressionando Ctrl + Espaço.
• Para impedir que Enter insira sugestões de preenchimento automático, alterne tecla Enter aceita sugestões de preenchimento automático.

Correspondência entre colchetes

Quando você clica perto de um parêntese, colchete ou chaves, o editor realça esse caractere e seu colchete correspondente.

Realce de erros em Python

Quando um notebook está conectado a um cluster, os erros de sintaxe são sublinhados em vermelho. Para o Python, o cluster precisa estar executando o Databricks Runtime 12.2 LTS ou superior.

Focalize no aviso de sintaxe e selecione Correção Rápida para conferir as ações possíveis.

Os workspaces com o Assistente do Databricks habilitado também podem selecionar Correção com assistente para receber sugestões assistidas por IA.

Para habilitar ou desabilitar o realce de erro de sintaxe, faça o seguinte:

1. Clique no nome de usuário no canto superior direito do workspace e clique em Configurações na lista suspensa.
2. Na barra lateral Configurações, selecione Desenvolvedor.
3. Na seção Editor de código, alterne a configuração para realce de erro de sintaxe SQL ou realce de erro de sintaxe Python.

Realce de formatação Python

Erros e avisos de formatação de código Python são sublinhados em amarelo. Passe o mouse sobre os avisos de sintaxe para ver mais informações. O cluster deve estar executando o Databricks Runtime 12.1 LTS ou superior.

Para ativar erros e avisos de formatação:

1. Clique no nome de usuário no canto superior direito do workspace e clique em Configurações na lista suspensa.
2. Na barra lateral Configurações, selecione Desenvolvedor.
3. Na seção Recursos experimentais, alterne a configuração para Erro de formato Python realçando.