Navegue pelo bloco de anotações e editor de arquivos Databricks

Este artigo descreve as funções disponíveis para ajudá-lo a navegar no bloco de anotações e no editor de arquivos Databricks, incluindo atalhos de teclado, sugestões de código e preenchimento automático, inspeção de variáveis e dobragem de código. 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. Veja Ajuda de Codificação do Databricks Assistant para obter detalhes.

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

Paleta de comandos

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

Minimapa de execução de células

Para obter uma visão geral do status de execução do seu bloco de anotações, use o minimapa de execução da célula. O minimapa aparece na margem direita e mostra uma barra de status para cada célula executável.

As barras de status indicam os seguintes estados de execução:

• Cinzento claro: A célula é estática.
• Cinzento escuro: a célula é ignorada ou colocada na fila para execução.
• Cinzento claro com barra móvel: A célula está atualmente em execução.
• Verde: Célula executada com êxito sem erros.
• Vermelho: Célula falhou com um erro.

Para interagir com o minimapa:

• Passe o cursor sobre o minimapa para ver uma lista de células executáveis, seus títulos e seus estados de execução.
• Clique em uma entrada para ir diretamente para essa célula no bloco de anotações.
• Clique em Ir para a última célula de execução ou Ir para a primeira célula com falha para navegar até a célula executada mais recentemente ou a primeira célula com falha.

O minimapa ajuda você a acompanhar o progresso da execução rapidamente e navegar rapidamente durante a depuração ou o desenvolvimento.

Localizar e substituir texto

Para localizar e substituir texto num bloco de notas Cmd + F , utilize o atalho de teclado (Mac) ou Ctrl + F(Windows) ou clique em Editar > Localizar... para abrir a caixa de diálogo Localizar . Introduza o texto que pretende localizar. A partida atual é destacada em laranja e todas as outras partidas são destacadas em amarelo. Para acessar a pesquisa nativa do navegador, pressione Cmd + F (Mac) ou Ctrl + F(Windows) novamente.

Clique no para aceder à opção Substituir. Em vez disso, introduza o texto que pretende utilizar. Para substituir a correspondência atual, clique em Alterar. Para alterar todas as correspondências no bloco de notas, clique em Substituir Tudo.

Para se mover entre correspondências, clique no (correspondência anterior) ou (próxima partida). Você também pode pressionar Shift + Enter e Enter para ir para as partidas anteriores e próximas, respectivamente.

Para fechar a ferramenta de localização e substituição, clique no ou pressione ESC.

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.

Ver explorador de variáveis.

Ir para a definição

Quando um caderno Python está associado a um recurso de computação, pode rapidamente aceder à definição de variável, função, módulo do sistema ou o código por detrás de uma %run instrução.

Para isso, mantenha pressionada a tecla Cmd no macOS ou a tecla Ctrl no Windows e passe o rato sobre a variável, o nome da função ou o módulo do sistema. Se uma definição for encontrada, o nome se transformará em um hiperlink. Clique no link para aceder à sua definição, que pode abrir num novo separador. Também pode clicar com o botão direito e depois clicar em Ir para definição ou Espreitar definição.

A funcionalidade "ir à definição" está disponível no Databricks Runtime 12.2 LTS e superiores e no ambiente sem servidor 1 e superiores.

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 múltipla de 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. Then:

• 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 múltipla de 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. Then:
  • 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 usuário no canto superior direito do ambiente de trabalho e depois selecione Definições na lista pendente.
2. Na barra lateral Configurações, selecione Developer.
3. Na seção Code editor, altere a definição de Modificador de tecla para clique com múltiplos cursores para Cmd no macOS ou Ctrl no Windows.

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

Procurar dados

Use o navegador de esquema para explorar os objetos do Catálogo Unity disponíveis para o notebook. Clique no no lado esquerdo do bloco de anotações, para abrir o navegador de esquemas.

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

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

Para abrir o , 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 numa nova célula no menu kebab da tabela.
• Exiba um catálogo, esquema ou tabela no Gerenciador de Catálogos. Selecione Abrir no Catalog Explorer no menu kebab. Uma nova guia é aberta mostrando o objeto selecionado.
• Obtenha o caminho para um catálogo, esquema ou tabela. Selecione Copiar ... caminho do menu kebab para o objeto.
• Adicione uma tabela aos Favoritos. Selecione Adicionar aos favoritos no menu kebab da mesa.

Se o objeto for um catálogo, esquema ou volume, você poderá copiar o caminho do objeto ou abri-lo no Gerenciador de Catálogos.

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

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

Usar terminal web e CLI do Databricks

Para abrir o terminal Web num bloco de notas, clique no ícone do terminal na parte inferior da barra lateral direita.

No Databricks Runtime 15.0 e versões posteriores, você pode usar a CLI do Databricks do terminal web em um notebook. Consulte Executar comandos de shell no terminal Web do Azure Databricks para obter requisitos e informações de uso.

Não é possível usar a CLI de uma célula de um notebook. Num bloco de anotações, comandos como %sh databricks ... não funcionam com o Databricks Runtime 15.0 ou superior.

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, nomes de tabelas, estruturas, mapas, matrizes e trechos de consulta. Ao fazer referência a expressões de tabela comuns (CTEs) que usam SELECT *o , o preenchimento automático fornece recomendações de coluna com base na estrutura da tabela subjacente. O Databricks usa seus metadados e uso do Catálogo Unity para personalizar sugestões.

• Para células Python, o notebook deve estar anexado a um recurso de computação para que o preenchimento automático funcione, e deve-se 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 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 Unity Catalog, o bloco de anotações deverá ser anexado a um recurso de computação multiuso 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.

Note

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

O Preenchimento automático está ativado por predefinição, mas pode ser desativado nas suas definições de utilizador:

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

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.

Realce de erro do Python

Os espaços de trabalho com funcionalidades de IA impulsionadas por parceiros ativadas também podem selecionar Reparar com Assistente para sugestões auxiliadas por IA.

Os notebooks Databricks suportam o seguinte destaque de erro:

• Realce de erro de sintaxe do Python: Todos os erros de sintaxe nas células de código Python são realçados em vermelho. Se possível, o Assistente irá sugerir uma solução rápida para você. Isso é suportado para computação executando o Databricks Runtime 12.1 e superior ou computação sem servidor. Você pode configurar o realce de erro de sintaxe com arquivos pyproject.toml. Veja como configurar o realce de sintaxe Python.
• Destaque de erro de formato Python: erros de formatação de código Python e avisos são sublinhados em amarelo ou vermelho, dependendo da gravidade. Isso pode ajudar a identificar problemas de formatação, como recuo inesperado, comprimento de linha longa e muito mais. Passe o cursor sobre os avisos de sintaxe para ver mais informações. Isso é suportado para computação executando o Databricks Runtime 12.1 e superior ou computação sem servidor.
• Destaque de erro de tipo Python: A verificação de tipo pode melhorar a qualidade, legibilidade e manutenção do código em projetos Python e PySpark. Os verificadores de tipo podem sinalizar erros relacionados a atributos inexistentes, argumentos ausentes e argumentos incompatíveis em chamadas de função antes da execução do código. Passe o cursor sobre os avisos destacados para ver mais informações. Isso é suportado para computação executando o Databricks Runtime 16.0 e superior ou ambiente sem servidor 2.

Ativar realce de erro Python

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

1. Clique no seu nome de usuário no canto superior direito do ambiente de trabalho e depois selecione Definições na lista pendente.
2. Na barra lateral Configurações, selecione Developer.
3. Alterne a configuração para realce de erro de sintaxe Python (em Editor de código), Realce de erro de formato Python (em Recursos experimentais) e/ou Realce de erro de tipo Python (em Recursos experimentais).

Configurar realce de sintaxe de Python

Quando um notebook está conectado à computação que executa o Databricks Runtime 16.4 ou superior ou ao ambiente sem servidor versão 3 ou superior, pode-se personalizar o comportamento do realce de sintaxe criando um arquivo pyproject.toml. Para um determinado bloco de anotações, será usado o arquivo mais próximo pyproject.toml em seu caminho ancestral direto no Sistema de Arquivos do Espaço de Trabalho. Se não for possível encontrar um no percurso do ancestral, será utilizado um ficheiro pyproject.toml na pasta de início do utilizador atual.

Por exemplo, se você tem um bloco de anotações com o caminho a/b/c/d/notebook.py e há pyproject.toml arquivos em a/b/pyproject.toml e a/b/c/pyproject.toml , em seguida, o segundo será usado, uma vez que está mais próximo. Um pyproject.toml arquivo em /a/b/c/e/pyproject.toml não seria considerado porque não está no caminho do ancestral direto .

O Azure Databricks usa sintaxe padrão para pyproject.toml arquivos. Por exemplo, você pode consultar a documentação do Ruff para ver como configurar o Ruff linter com um pyproject.toml arquivo.

Atualmente, o Azure Databricks suporta apenas a configuração de ruff, pylint, pyright e flake8 para análise de códigos através de pyproject.toml.

Para habilitar um linter, o ficheiro pyproject.toml precisa de conter um bloco [tool.<name-of-linter>].

Para desativar explicitamente um linter, adicione o seguinte bloco:

[tool.<name-of-linter>]
disabled=true

Você também pode desabilitar as regras de realce de sintaxe escritas pelo Azure Databricks com um bloco como:

[tool.databricks]
disabled_rules = ['DB01', 'DB03']

Como Flake8 espera uma configuração em um formato diferente, você precisa passar a configuração para Flake8 como uma cadeia de caracteres:

[tool.flake8]
config = """ \
[flake8] \
extend_ignore = E303 \
"""

Personalizar a formatação SQL

Você pode personalizar as configurações de formatação SQL no novo editor SQL e no editor de bloco de anotações. Clique em Exibir > configurações do desenvolvedor. Role para baixo até Formato SQL e especifique suas configurações.

Usar 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).

As tabelas abaixo mostram os atalhos de teclado disponíveis.

Atalhos do modo de edição

Função	Atalho do MacOS	Atalho do Windows
Mudar para o Modo de Comando	Esc	Esc
Executar comando e inserir nova célula abaixo	Option + Enter	Alt + Enter
Inserir uma célula acima	Ctrl + Option + P	Ctrl + Alt + P
Inserir uma célula abaixo	Ctrl + Option + N	Ctrl + Alt + N
Mover para a célula anterior/seguinte	Option + Up/Down	Alt + Up/Down
Dividir uma célula no cursor	Ctrl + Option + -	Ctrl + Alt + -
Excluir linha atual	⌘ + Shift + K	Ctrl + Shift + K
Excluir célula atual	Ctrl + Option + D	Ctrl + Alt + D
Mover para cima ou para a célula anterior	Up	Up
Mover para baixo ou para a próxima célula	Down	Down
Preenchimento Automático	Ctrl + Space	Ctrl + Space
Assistente Automático de Preenchimento Automático	Ctrl + Shift + Space	Ctrl + Shift + Space
Assistente Inline	⌘ + I	Ctrl + I
Dicas de parâmetros	⌘ + Shift + Space	Ctrl + Shift + Space
Cadeia de caracteres	⌘ + (K, I)	Ctrl + (K, I)
Vários cursores	Option + Click	Alt + Click
Coluna (caixa) selecione	Option + Shift + Drag	Alt + Shift + Drag
Seleção de recuo/recuo	⌘ + ]/[	Ctrl + ]/[
Desfazer digitação	⌘ + Z	Ctrl + Z
Refazer digitação	⌘ + Shift + Z	Ctrl + Shift + Z
Alternar comentário de linha	⌘ + /	Ctrl + /
Adicionar comentário de linha	⌘ + (K, C)	Ctrl + (K, C)
Remover comentário de linha	⌘ + (K, U)	Ctrl + (K, U)
Edição com vários cursores	⌘ + Option + Up/Down	Ctrl + Option + Up/Down
Aumentar o tamanho do tipo de letra	Option + +	Alt + +
Diminuir o tamanho da fonte	Option + -	Alt + -

Atalhos do modo de comando

Função	Atalho do Mac OS	Atalho do Windows
Mudar para o Modo de Edição	Enter	Enter
Cancelar a execução de células selecionadas	I, I	I, I
Cancelar execução (prompt de salto)	Shift + (I, I)	Shift + (I, I)
Excluir célula atual	D, D	D, D
Excluir célula atual (ignorar prompt)	Shift + (D, D)	Shift + (D, D)
Ir para a primeira célula	G, G	G, G
Ir para a última célula	Shift + G	Shift + G
Desfazer cortar/excluir células	⌘ + Z/Z	Ctrl + Z/Z
Copiar célula atual	⌘ + C	Ctrl + C
Cortar célula de corrente	⌘ + X	Ctrl + X
Colar célula	⌘ + V	Ctrl + V
Inserir uma célula acima	A	A
Inserir uma célula abaixo	B	B
Alternar saída de célula	O	O
Alternar o título da célula	T	T
Deslizar para baixo	Space	Space
Deslocar para cima	Shift + Space	Shift + Space
Alternar menu de atalhos de teclado	H	H
Mesclar com a célula abaixo	Shift + M	Shift + M
Mover para a célula anterior	Up/P/K	Up/P/K
Mover para a próxima célula	Down/N/J	Down/N/J
Adicionar célula adjacente à seleção	Shift + Up/Down	Shift + Up/Down
Selecionar todas as células	⌘ + A	Ctrl + A
Selecionar várias células	⌘ + Click	Ctrl + Click
Alternar números de linha	L	L
Expandir/Recolher cabeçalhos de células	Right/Left	Right/Left

Atalhos partilhados

Função	Atalho do MacOS	Atalho do Windows
Alternar paleta de comandos	⌘ + Shift + P	Ctrl + Shift + P
Localizar	⌘ + F	Ctrl + F
Substituir	Ctrl + Option + F	Ctrl + Alt + F
Código de formato	⌘ + Shift + F	Ctrl + Shift + F
Executar comando e mover para a próxima célula	Shift + Enter	Shift + Enter
Executar comando(s) selecionado(s)	⌘ + Enter	Ctrl + Enter
Célula de depuração	Option + Shift + D	Alt + Shift + D
Depurador: Continuar	F7	F7
Depurador: Próxima linha	F8	F8
Depurador: Entre em	F9	F9
Depurador: Step out	Shift + F9	Shift + F9
Executar todos os comandos	Option + Shift + Enter	Alt + Shift + Enter
Executar todos os comandos acima (exclusivo)	Option + Shift + Up	Alt + Shift + Up
Execute todos os comandos abaixo (inclusive)	Option + Shift + Down	Alt + Shift + Down
Limpar estado e saídas	0, 0	0, 0
Executar texto selecionado ou instrução ativa	Ctrl + Shift + Enter	Ctrl + Shift + Enter
Executar instrução SQL ativa	⌘ + Shift + Enter	Ctrl + Shift + Enter
Mover uma célula para cima	Ctrl + Option + Up	Ctrl + Alt + Up
Mover uma célula para baixo	Ctrl + Option + Down	Ctrl + Alt + Down
Alternar painel de comentários / adicionar comentário	Ctrl + Option + M	Ctrl + Alt + M
Alternar painel de espaço de trabalho	Ctrl + Option + E	Ctrl + Alt + E
Painel Alternar catálogo	Ctrl + Option + C	Ctrl + Alt + C
Painel do assistente de alternância	Ctrl + Option + A	Ctrl + Alt + A
Alternar o modo de foco	Ctrl + Option + O	Ctrl + Alt + O
Fechar separador atual	Ctrl + Option + W	Ctrl + Alt + W
Criar novo separador	Ctrl + Option + T	Ctrl + Alt + T
Mudar para o separador esquerdo	Ctrl + Option + Left	Ctrl + Alt + Left
Mudar para o separador da direita	Ctrl + Option + Right	Ctrl + Alt + Right
Fechar todos os separadores	Ctrl + Option + Shift + A	Ctrl + Alt + Shift + A