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

Esta página descreve algumas 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 personalizado

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. O Databricks usa seus metadados e uso do Catálogo Unity para personalizar sugestões.

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

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.

Consulte Explorador de variáveis

Ir para a definição

Quando um bloco de anotações 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 %run instrução. Para fazer isso, clique com o botão direito do mouse no nome da variável ou 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 passe o mouse sobre o nome da variável ou 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.

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 do Python

Quando um bloco de notas está ligado a um cluster, os erros de sintaxe são sublinhados a vermelho. Para Python, o cluster deve estar executando o Databricks Runtime 12.2 LTS ou superior.

Passe o cursor sobre o aviso de sintaxe e selecione Correção Rápida para possíveis ações.

Os espaços de trabalho com o Databricks Assistant ativado também podem selecionar Corrigir com o Assistente para sugestões assistidas por IA.

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.

Realce de formatação Python

Os erros e avisos de formatação de código Python são sublinhados em amarelo. Passe o cursor 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 de formatação e avisos:

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 Recursos experimentais, alterne a configuração para realce de erro de formato Python