Usar o bloco de anotações e o editor de arquivos Databricks

Esta página descreve algumas das funções disponíveis com o notebook e editor de arquivos Databricks, incluindo sugestões de código e preenchimento automático, inspeção variável, dobragem de código e diffs lado a lado. Quando você usa o bloco de anotações ou o editor de arquivos, o Assistente Databricks está disponível para ajudá-lo a gerar, explicar e depurar código. Consulte Usar o Databricks Assistant 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 completa automaticamente os segmentos de código à medida que você os digita. Os objetos conclusíveis incluem tipos, classes e objetos, bem como banco de dados SQL e nomes de tabela.

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

As sugestões de preenchimento automático aparecem automaticamente 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.

Nota

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

Há duas configurações de usuário a serem observadas:

• Para desativar as sugestões de preenchimento automático, alterne o Preenchimento automático enquanto 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, a tecla Enter aceita sugestões de preenchimento automático.

Inspeção variável

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

Ir para a definição

No Databricks Runtime 12.2 LTS e superior, quando um bloco de anotações Python é conectado a um cluster, você pode navegar automaticamente até a definição de uma variável ou função definida nesse bloco de anotações. Para fazer isso, mantenha pressionada a tecla Cmd no macOS ou a tecla Ctrl no Windows e passe o cursor sobre o nome da variável ou função. O nome se transforma em um hiperlink e muda para texto azul sublinhado se a definição for encontrada. Quando você clica no link, o cursor se move para o código que define a variável ou função.

Também pode utilizar os atalhos de teclado Cmd+F12 no macOS ou Ctrl+F12 no Windows.

Dobragem de código

A dobragem 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 está trabalhando.

Para ocultar o código, coloque o cursor na extremidade esquerda de uma célula. As setas apontando para baixo aparecem em pontos lógicos onde 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, como mostra o vídeo:

Para criar vários cursores numa célula:

• No macOS, mantenha pressionada a Option tecla e clique em cada local para adicionar um cursor.
• No Windows, mantenha pressionada a Alt tecla e clique em cada local para adicionar um cursor.
• Você também tem a opção de alterar o atalho. Consulte Alterar atalho para seleção de vários cursores e colunas.

No macOS, você pode criar vários cursores alinhados verticalmente usando o atalho Option+Commandde teclado + 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 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. Consulte Alterar atalho para seleção de vários cursores e colunas.

Alterar atalho para seleção de vários cursores e colunas

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

• Para criar vários cursores numa célula:
  • No macOS, mantenha pressionada a Cmd tecla e clique em cada local para adicionar um cursor.
  • No Windows, mantenha pressionada a Ctrl tecla 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 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 seu nome de utilizador no canto superior direito da área de trabalho e, em seguida, clique em Definições na lista pendente.
2. Na barra lateral Configurações, selecione Desenvolvedor.
3. Na seção Editor de código , altere a configuração Modificador de tecla 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 parênteses

Quando você clica perto de um parêntese, colchete ou chave, o editor destaca esse caractere e seu colchete correspondente.

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

Quando você exibe versões anteriores do bloco de anotações, o editor exibe diferenciais lado a lado com realce de cor.

Realce de erro de sintaxe

Quando um bloco de anotações é conectado a um cluster, os erros de sintaxe são realçados por uma linha vermelha ondulada. Para Python, o cluster deve estar executando o Databricks Runtime 12.2 LTS ou superior.

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

1. Clique no seu nome de utilizador no canto superior direito da área de trabalho e, em seguida, clique em Definições na lista pendente.
2. Na barra lateral Configurações, selecione Desenvolvedor.
3. Na seção Editor de códigos, alterne a configuração para realce de erro de sintaxe SQL ou realce de erro de sintaxe Python.

Possíveis ações sobre erros de sintaxe e avisos

Quando vir um erro de sintaxe, pode passar o rato sobre ele e selecionar Correção Rápida para possíveis ações.

Nota

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