Use o Databricks Notebook e o editor de arquivos

Esta página descreve algumas das funções disponíveis com o Databricks Notebook e o editor de arquivos, incluindo sugestões de código e preenchimento automático, inspeção de variáveis, dobragem de código e diferenças lado a lado. Quando o senhor usa o site Notebook ou o editor de arquivos, o Databricks Assistant está disponível para ajudá-lo a gerar, explicar e depurar o código. Consulte Usar o Databricks Assistant para obter detalhes.

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

autocompletar

O preenchimento automático completa automaticamente os segmentos de código conforme você os digita. Objetos completáveis incluem tipos, classes e objetos, bem como bancos de dados SQL e nomes de tabelas.

  • Para células Python, o Notebook deve ser anexado a clusters 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 compute .

    • Se o workspace estiver habilitado para Unity Catalog, o preenchimento automático também sugerirá nomes de catálogo, esquema, tabela e coluna para tabelas no Unity Catalog.

    • Se o workspace não estiver ativado para o Unity Catalog, o Notebook 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 key 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 do servidor no R Notebook é 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 você digita. Quando o preenchimento automático está desativado, você pode exibir sugestões de preenchimento automático pressionando Ctrl + Espaço.

  • Para evitar que Enter insira sugestões de preenchimento automático, alterne key Enter para aceitar sugestões de preenchimento automático.

Inspeção variável

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

como inspecionar uma variável

Ir para a definição

No Databricks Runtime 12.2 LTS e acima, quando um Python Notebook é anexado a clusters, você pode navegar automaticamente para a definição de uma variável ou função definida nesse Notebook. Para fazer isso, mantenha pressionada a key Cmd no macOS ou key 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 sublinhado em azul se a definição for encontrada. Ao clicar no link, o cursor se move para o código que define a variável ou função.

Você também pode usar 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 porque 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. 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.

como dobrar código

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

Suporte multicursor

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

como usar vários cursores

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

  • No macOS, mantenha pressionada a key Option e clique em cada local para adicionar um cursor.

  • No Windows, mantenha pressionada a key Alt e clique em cada local para adicionar um cursor.

  • Você também tem a opção de alterar o atalho. Consulte Alterar atalho para multicursor e seleção de coluna.

No macOS, você pode criar vários cursores alinhados verticalmente usando o keyde key Option+Command+ 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. Então:

  • 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 multicursor e seleção de coluna.

como selecionar colunas

Alterar atalho para multicursor e seleção de coluna

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

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

    • No macOS, mantenha pressionada a key Cmd e clique em cada local para adicionar um cursor.

    • No Windows, mantenha pressionada a key 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 deseja capturar. Então:

    • 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 ativar os atalhos alternativos, faça o seguinte:

  1. Clique no seu nome de usuário no canto superior direito do site workspace e, em seguida, clique em Settings (Configurações ) na lista dropdown.

  2. Na barra lateral Configurações , selecione Desenvolvedor.

  3. Na seção Editor de código , altere a configuração do modificadorkey para clique com vários cursores para Cmd para macOS ou Ctrl para Windows.

Quando você ativa atalhos alternativos, o atalho de teclado para criar vários cursores alinhados verticalmente não é alterado.

Correspondência de colchetes

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

mostre o colchete correspondente

Diferença lado a lado na história da versão

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

mostrar as diferenças de código

Destaque de erro de sintaxe

Quando um Notebook está conectado a um cluster, os erros de sintaxe são destacados por uma linha vermelha ondulada. Para Python, o cluster deve estar executando Databricks Runtime 12.2 LTS ou acima.

exemplo de destaque de erro de sintaxe

Para ativar ou desativar o realce de erros de sintaxe, faça o seguinte:

  1. Clique no seu nome de usuário no canto superior direito do site workspace e, em seguida, clique em Settings (Configurações ) na lista dropdown.

  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.

Possíveis ações 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.

exemplo para ações de código no destaque de erros de sintaxe

Observação

Esse recurso usa o Databricks Assistant. Se o senhor não vir nenhuma ação, isso significa que o administrador precisa primeiro ativar o Databricks Assistant.