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.

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

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

Localizar e substituir texto

Para localizar e substituir texto num bloco de notas, selecione Editar > Localizar e Substituir. A partida atual é destacada em laranja e todas as outras partidas são destacadas em amarelo.

Para substituir a correspondência atual, clique em Alterar. Para alterar todas as correspondências no bloco de notas, clique em Substituir Tudo.

Para mover entre as correspondências, clique nos botões Anterior e Avançar. Você também pode pressionar shift+enter e digitar para ir para as partidas anteriores e seguintes, respectivamente.

Para fechar a ferramenta de localização e substituição, clique Excluir ícone 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 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 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. 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 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. 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 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 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.

Explorar dados

Use o navegador de esquema para explorar os objetos do Catálogo Unity disponíveis para o notebook. Clique no ícone de dados do notebook no lado esquerdo do notebook para abrir o navegador de esquemas.

O botão Para você exibe apenas os objetos que você usou na sessão atual ou marcou 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 menu Kebab , 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 do painel inferior na parte inferior da barra lateral direita.

Usar a CLI do Databricks em um terminal da Web

A partir do Databricks Runtime 15.0, você pode usar a CLI do Databricks a partir do terminal da Web no notebook.

Requerimentos

• O bloco de anotações deve ser conectado a um cluster no modo de acesso de utilizador único ou compartilhado sem isolamento.
• A CLI não está disponível em espaços de trabalho habilitados para Link Privado.

A CLI instalada é sempre a versão mais recente. A autenticação é baseada no usuário atual.

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 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 notebook deve ser anexado a um cluster ou a um armazém SQL de 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.

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

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.

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

Os espaços de trabalho com Databricks Assistant ativado também podem selecionar Corrigir com 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 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 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 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 recursos experimentais do , alterne a configuração para erro de formato Python realce.