Usar o notebook e o editor de arquivos do Databricks

Esta página descreve algumas das funções disponíveis com o notebook e o editor de arquivos do Databricks, incluindo sugestões de código e preenchimento automático, inspeção variável, dobramento de código e diferenças lado a lado. 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. Consulte Usar o 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.

Preenchimento automático

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.

• 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.

Observação

O preenchimento automático de servidor em notebooks R é bloqueado durante a execução do comando.

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.

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.

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.

Você também pode manter pressionada a tecla Cmd no macOS ou tecla Ctrl no Windows e passar o mouse sobre a variável ou o nome da função. O nome se transformará em um hiperlink se uma definição for encontrada.

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, você pode criar vários cursores alinhados verticalmente usando o atalho de teclado Option+Command+ seta para cima ou seta 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 de teclado para criar vários cursores alinhados verticalmente não é alterado.

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.

Comparação lado a lado no histórico de versões

Quando você exibe versões anteriores do notebook, o editor exibe diferenças lado a lado com realce de cores.

Realce de erro de sintaxe

Quando um notebook é conectado a um cluster, os erros de sintaxe são realçados por uma linha vermelha irregular. Para o Python, o cluster precisa estar executando o Databricks Runtime 12.2 LTS ou superior.

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.

Ações possíveis em erros de sintaxe e avisos

Ao ver um erro de sintaxe, você pode passar o mouse sobre ele e selecionar Correção Rápida para possíveis ações.

Observação

Esse recurso usa o Assistente do Databricks. Se você não vir nenhuma ação, isso significa que seu administrador precisa habilitar o Assistente do Databricks primeiro.