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

Esta página descreve as funções disponíveis para o ajudar a navegar no caderno e editor de ficheiros Databricks, incluindo atalhos de teclado, sugestões de código e autocompletamento, inspeção de variáveis e dobra de código. Quando usa o caderno ou o editor de ficheiros, o Genie Code está disponível para o ajudar a gerar, explicar e depurar código. Consulte Obter ajuda de programação no Genie Code para mais detalhes.

Pode escolher entre uma seleção de temas para editores. Selecione Ver > Tema do Editor e faça uma seleção no menu.

Modo de edição e modo de comando

Os notebooks Databricks têm dois modos de interação:

• O modo de edição está ativo quando o cursor está dentro de uma célula. Neste modo, pode escrever e editar código ou texto dentro da célula. Um cursor a piscar aparece na célula para indicar o modo de edição. Clique duas vezes numa célula ou pressione Enter para mudar do modo de comando para o modo de edição. Pressione Esc para sair do modo de edição.
• O modo de comando está ativo quando nenhuma célula está a ser editada. Neste modo, operas nas células como unidades. Pode selecionar, cortar, copiar, colar, apagar, mover e reorganizar as células. Pressione Esc para mudar do modo de edição para o modo de comando. Pressione Enter para sair do modo de comando.

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 caderno, clique em no canto inferior direito do espaço 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 devido a 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 encontrar e substituir texto dentro de um caderno, use o atalho de teclado, Cmd + F (Mac) ou Ctrl + F(Windows), ou clique em Editar > Encontrar... para abrir o diálogo Find. Introduza o texto que pretende localizar. A partida atual é destacada em laranja e todas as outras partidas são destacadas em amarelo. Para aceder à pesquisa integrada do navegador, pressione novamente Cmd + F (Mac) ou Ctrl + F(Windows).

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 mostrar informação sobre uma variável definida num caderno SQL ou Python, passe o cursor sobre o nome da variável. A inspeção de variáveis em Python requer Databricks Runtime 12.2 LTS ou superior.

Ver explorador de variáveis.

Ir para a definição

Quando um Python notebook 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 trás de uma instrução %run.

Para isso, mantenha pressionada a tecla Cmd no macOS ou a tecla Ctrl no Windows e passe o rato sobre a variável, nome da função ou 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, mantém pressionada a tecla Alt e clica 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, mantém pressionada a tecla Ctrl e clica 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 ativar os atalhos alternativos, faça o seguinte:

1. Clique no seu nome de utilizador no canto superior direito do espaço de trabalho e depois clique em Definições na lista suspensa.
2. Na barra lateral Configurações, selecione Developer.
3. Na secção do editor de código, altere o modificador de tecla para clique com múltiplos cursores para Cmd para macOS ou Ctrl para Windows.

Quando ativas atalhos alternativos, o atalho de teclado para criar múltiplos cursores alinhados verticalmente não muda.

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

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 shell no terminal web do Azure Databricks para informações sobre requisitos e utilização.

Não é possível usar o CLI a partir de uma célula de caderno. Num caderno, comandos como %sh databricks ... não funcionam com 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 referenciar expressões de tabela comuns (CTEs) que usam SELECT *, o preenchimento automático fornece recomendações de coluna baseadas na estrutura da tabela subjacente. O Databricks usa seus metadados e uso do Catálogo Unity para personalizar sugestões.

• Para as células Python, o notebook deve estar anexado a um recurso de computação para que o autocompletar funcione, e deve executar todas as células que definem objetos completáveis.
• Para células SQL, o autocomplete sugere palavras-chave e sintaxe básica mesmo que o caderno não esteja associado 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 ativado para o Unity Catalog, o caderno deve estar ligado 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.

Destacar erros de 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:

• Python realçamento de erro de sintaxe: Quaisquer erros de sintaxe nas células de código de Python são destacados a vermelho. Se possível, a Genie Code sugere uma solução rápida para si. 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 configurar o realce de sintaxe para Python.
• Destacar erros de formatação em Python: Erros de formatação do código Python e avisos são marcados a amarelo ou vermelho, dependendo da sua 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.
• Destacamento de erros de tipo em Python: A verificação de tipos pode melhorar a qualidade do código, legibilidade e manutenibilidade 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 o realce de erros em Python

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

1. Clique no seu nome de utilizador no canto superior direito do espaço de trabalho e depois clique em Definições na lista suspensa.
2. Na barra lateral Configurações, selecione Developer.
3. Alterne a definição para realce de erro de sintaxe em Python (no editor de código), realce de erro de formato em Python (em Funcionalidades experimentais), e/ou realce de erro de tipo em Python (em Funcionalidades experimentais).

Configurar destaque de sintaxe 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 dado caderno, é utilizado o ficheiro mais pyproject.toml próximo na sua trajetória ancestral direta no Sistema de Ficheiros do Workspace. Se não for possível encontrar um no caminho ancestral, então é utilizado um ficheiro pyproject.toml na pasta do utilizador atual.

Por exemplo, se tiveres um caderno com o caminho a/b/c/d/notebook.py e há pyproject.toml ficheiros em a/b/pyproject.toml e a/b/c/pyproject.toml depois o segundo é usado porque 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 .

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

Atualmente, Azure Databricks só suporta a configuração de ruff, pylint, pyright e flake8 para linting até pyproject.toml.

Para ativar um linter, o pyproject.toml ficheiro deve ter um [tool.<name-of-linter>] bloco.

Para desativar explicitamente um linter, adicione o seguinte bloco:

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

Também pode desativar 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

Podes personalizar as definições para formatação SQL no novo editor SQL e no editor de cadernos. 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 através do 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 célula seguinte	Down	Down
Preenchimento Automático	Ctrl + Space	Ctrl + Space
Assistente Automático de Preenchimento Automático	Ctrl + Shift + Space	Ctrl + Shift + Space
Assistente em linha	⌘ + I	Ctrl + I
Dicas de parâmetros	⌘ + Shift + Space	Ctrl + Shift + Space
Cadeia de documentação	⌘ + (K, I)	Ctrl + (K, I)
Vários cursores	Option + Click	Alt + Click
Coluna (caixa) selecione	Option + Shift + Drag	Alt + Shift + Drag
Indentar/desindentar seleção	⌘ + ]/[	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 macOS	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 (ignorar a solicitação)	Shift + (I, I)	Shift + (I, I)
Excluir célula atual	D, D	D, D
Eliminar célula atual (ignorar aviso)	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 ou excluir células	⌘ + Z/Z	Ctrl + Z/Z
Copiar célula atual	⌘ + C	Ctrl + C
Cortar célula de corrente	⌘ + X	Ctrl + X
Colar conteúdo na 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
Ir 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 de erros	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
Executar todos os seguintes comandos, incluindo o último	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
Alternar painel de catálogo	Ctrl + Option + C	Ctrl + Alt + C
Painel de alternância do assistente	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 à direita	Ctrl + Option + Right	Ctrl + Alt + Right
Fechar todas as abas	Ctrl + Option + Shift + A	Ctrl + Alt + Shift + A