Escreva consultas e explore dados no editor SQL

A interface do usuário do Databricks inclui um editor SQL que o senhor pode usar para criar consultas, pesquisar dados disponíveis e criar visualizações. O senhor também pode compartilhar suas consultas salvas com outros membros da equipe no site workspace. Este artigo explica como usar o editor SQL para escrever, executar e gerenciar consultas. Uma nova versão do editor SQL está em Public Preview. Para saber como ativar e trabalhar com o novo editor de SQL, consulte Colaborar com colegas usando o novo editor de SQL.

Depois de abrir o editor, o senhor pode criar uma consulta SQL ou procurar os dados disponíveis. O editor de texto suporta preenchimento automático, formatação automática e vários outros atalhos de teclado.

O senhor pode abrir várias consultas usando a guia de consulta na parte superior do editor de texto. Cada consulta tab tem controles para executar a consulta, marcar a consulta como favorita e conectar-se a um site SQL warehouse. O senhor também pode salvar , programar ou compartilhar consultas.

Abra o editor SQL

Para abrir o editor SQL na interface do usuário do Databricks, clique em SQL Editor na barra lateral.

O editor SQL abre a última consulta aberta. Se nenhuma consulta existir ou se todas as suas consultas tiverem sido explicitamente fechadas, uma nova consulta será aberta. Ela é automaticamente chamada de Nova consulta e o carimbo de data e hora de criação é anexado ao título.

Conectar-se a compute

O senhor deve ter pelo menos permissões CAN USE em um site em execução SQL warehouse para executar as consultas. Você pode usar o menu suspenso próximo à parte superior do editor para ver as opções disponíveis. Para filtrar a lista, insira o texto na caixa de texto.

Na primeira vez que o senhor cria uma consulta, a lista de armazéns SQL disponíveis aparece em ordem alfabética. O último SQL warehouse usado é selecionado na próxima vez que o senhor criar uma consulta.

O ícone ao lado de SQL warehouse indica o status:

• Correndo
• Começando
• Parado

nota

Se não houver nenhum depósito SQL na lista, entre em contato com o administrador do workspace.

O site SQL warehouse selecionado será reiniciado automaticamente quando o senhor executar a consulta. Veja começar a SQL warehouse para aprender outras maneiras de começar a SQL warehouse.

Procurar objetos de dados no editor SQL

Se o senhor tiver permissão de leitura de metadados, o navegador de esquema no editor SQL mostrará os bancos de dados e as tabelas disponíveis. Você também pode procurar objetos de dados do Catalog Explorer.

O senhor pode navegar pelos objetos de banco de dados administrados pelo Unity Catalog no Catalog Explorer sem estar ativo em compute. Para explorar dados no hive_metastore e em outros catálogos não regidos por Unity Catalog, o senhor deve se conectar a compute com os privilégios apropriados. Veja governança de dados com Unity Catalog.

nota

Se não houver objetos de dados no schema browser ou no Catalog Explorer, entre em contato com o administrador do site workspace.

Clique em próximo à parte superior do navegador de esquemas para acessar refresh o esquema. O senhor pode filtrar o esquema digitando filter strings na caixa de pesquisa.

Clique no nome de uma tabela para mostrar as colunas dessa tabela.

Crie uma consulta

O senhor pode inserir texto para criar uma consulta no editor SQL. Você pode inserir elementos do navegador de esquemas para referenciar catálogos e tabelas.

1. Digite sua consulta no editor SQL.

   O editor SQL suporta o preenchimento automático. Conforme você digita, o preenchimento automático sugere conclusões. Por exemplo, se um preenchimento válido no local do cursor for uma coluna, o preenchimento automático sugere um nome de coluna. Se você digitar select * from table_name as t where t., o preenchimento automático reconhecerá que t é um alias para table_name e sugere as colunas dentro de table_name.

   

2. (Opcional) Quando terminar de editar, clique em Salvar . Em default, a consulta é salva na pasta de usuário home, ou o usuário pode selecionar um local diferente. Em seguida, clique em Salvar .

Ativar e desativar o preenchimento automático

O autocompletar em tempo real pode completar tokens de esquema, identificadores de sintaxe de consulta (como SELECT e JOIN) e os títulos de trechos de consulta. Ele é ativado pelo site default, a menos que o esquema do banco de dados exceda cinco mil tokens (tabelas ou colunas).

Use o botão de alternância abaixo do editor SQL para ativar ou desativar o preenchimento automático em tempo real.

• Para desativar o autocompletar ao vivo, pressione Ctrl + Espaço ou clique no botão abaixo do editor SQL.

Salvar consultas

O botão Save (Salvar ), próximo ao canto superior direito do editor SQL, salva a consulta.

important

Quando você modifica uma consulta, mas não clica explicitamente em Salvar , esse estado é mantido como rascunho de consulta. Os rascunhos da consulta são retidos por 30 dias. Após 30 dias, os rascunhos da consulta são excluídos automaticamente. Para manter suas alterações, você deve salvá-las explicitamente.

Editar várias consultas

Em default, o editor SQL usa tabulação para que o senhor possa editar várias consultas simultaneamente. Para abrir um novo tab, clique em + e selecione Create new query (Criar nova consulta ) ou Open existing query (Abrir consulta existente ). Clique em Abrir consulta existente para ver sua lista de consultas salvas. clique em Minhas consultas ou Favoritos para filtrar a lista de consultas. Na linha que contém a consulta que o senhor deseja view, clique em Open .

execução de uma única consulta ou de várias consultas

Para executar uma consulta ou todas as consultas:

1. Selecione um SQL warehouse.

2. Destaque uma consulta no editor SQL (se houver várias consultas no painel de consultas).

3. Pressione Ctrl/Cmd + Enter ou clique em executar (1000) para exibir os resultados como uma tabela no painel de resultados.

   

nota

Limit 1000 é selecionado por default para todas as consultas para limitar o retorno da consulta a 1000 linhas. Se uma consulta for salva com a configuração Limite 1000 , essa configuração se aplicará a todas as execuções de consultas (inclusive em painéis). Para retornar todas as linhas dessa consulta, o senhor pode desmarcar LIMIT 1000 clicando no menu suspenso execução (1000) . Se quiser especificar um limite diferente para o número de linhas, você pode adicionar uma cláusula LIMIT em sua consulta com um valor de sua escolha.

Encerrar uma consulta

Para encerrar uma consulta durante a execução, clique em Cancelar. Um administrador pode interromper a execução de uma consulta iniciada por outro usuário visualizando a opção Encerrar uma consulta em execução.

Opções de consulta

O senhor pode usar o menu de contexto kebab próximo à parte superior do editor de consultas para acessar as opções de menu para clonar, reverter, formatar e editar as informações da consulta.

Reverter para a consulta salva

Quando você edita uma consulta, a opção Reverter alterações aparece no menu de contexto da consulta. Você pode clicar em Reverter para voltar à sua versão salva.

Descartando e restaurando consultas

Para mover uma consulta para a lixeira:

• Clique no menu de contexto kebab ao lado da consulta no editor SQL e selecione Move to Trash (Mover para a lixeira ).
• Clique em Mover para a lixeira para confirmar.

Para restaurar uma consulta da lixeira:

1. Na lista Todas as consultas, clique em .
2. Clique em uma consulta.
3. Clique no menu de contexto kebab no canto superior direito do editor SQL e clique em Restore (Restaurar ).

Definir a descrição da consulta e view informações da consulta

Para definir uma descrição de consulta:

1. Clique no menu de contexto do kebab ao lado da consulta e clique em Editar informações da consulta .

   

2. Na caixa de texto Descrição , insira sua descrição. Em seguida, clique em Salvar . O senhor também pode acessar view o histórico da consulta, inclusive quando ela foi criada e atualizada, nessa caixa de diálogo.

Consultas de favoritos e tags

O senhor pode usar os favoritos e as tags para filtrar as listas de consultas e dashboards exibidos em suas páginas de aterrissagem workspace e em cada uma das páginas de listagem de dashboards e consultas.

Favoritos : para marcar uma consulta como favorita, clique na estrela à esquerda do título na lista Consultas. A estrela ficará amarela.

Tags : O senhor pode marcar consultas e painéis com quaisquer cadeias de caracteres significativas para sua organização.

Adicionar uma tag

Adicione tags no editor de consultas.

1. Clique no menu de contexto do kebab ao lado da consulta e clique em Editar informações da consulta . É exibida uma caixa de diálogo Informações da consulta .

2. Se a consulta não tiver tags aplicadas, a opção Adicionar algumas tags será exibida na caixa de texto onde as tags aparecerão. Para criar uma nova tag, digite-a na caixa. Para inserir várias tags, pressione tab entre as entradas.

   

3. Clique em Salvar para aplicar as tags e fechar a caixa de diálogo.

Remover tags

1. Clique no menu de contexto do kebab ao lado da consulta e clique em Editar informações da consulta .
2. Clique no X em qualquer tag que você queira remover.
3. Clique em Salvar para fechar a caixa de diálogo.

visualizar os resultados da consulta

Após a execução de uma consulta, os resultados aparecem no painel abaixo dela. A nova tabela de resultados está ATIVADA para novas consultas. Se necessário, clique no menu suspenso para desativá-lo. As imagens nesta seção usam a nova tabela de resultados.

Você pode interagir e explorar os resultados da consulta usando o painel de resultados. O painel de resultados inclui o seguinte recurso para explorar os resultados:

Visualizações, filtros e parâmetros

Clique em para adicionar uma visualização, filtro ou parâmetro. As seguintes opções são exibidas:

Visualização : as visualizações podem ajudar a explorar o conjunto de resultados. Consulte Tipos de visualização para obter uma lista completa dos tipos de visualização disponíveis.

Filtro : Os filtros permitem que o senhor limite o conjunto de resultados após a execução de uma consulta. Você pode aplicar filtros para mostrar seletivamente diferentes subconjuntos dos dados. Consulte Filtros de consulta para saber como usar filtros.

Parâmetro : os parâmetros permitem limitar o conjunto de resultados substituindo valores em uma consulta em tempo de execução. Consulte Trabalhar com parâmetros de consulta para saber como aplicar parâmetros.

Editar, download, ou adicionar a um painel

important

• Databricks recomenda o uso do AI/BI dashboards (anteriormente Lakeview dashboards). As versões anteriores dos painéis, anteriormente chamadas de Databricks SQL dashboards, agora são chamadas de legacy dashboards . A Databricks não recomenda a criação de novos painéis legados.

Cronograma de fim do suporte :

• 7 de abril de 2025 : o suporte oficial para a versão antiga dos painéis será encerrado. Somente problemas críticos de segurança e interrupções de serviço serão abordados.

• 3 de novembro de 2025 : A Databricks começará a arquivar painéis legados que não foram acessados nos últimos seis meses. Os painéis arquivados não estarão mais acessíveis e o processo de arquivamento ocorrerá de forma contínua. O acesso aos painéis usados ativamente permanecerá inalterado.

  A Databricks trabalhará com os clientes para desenvolver planos de migração para painéis legados ativos após 3 de novembro de 2025.

• Converta painéis antigos usando a ferramenta de migração ou a API REST. Consulte Clonar um painel legado para AI/BI dashboard para obter instruções sobre como usar a ferramenta de migração integrada. Consulte o tutorial do Dashboard para obter um tutorial sobre a criação e o gerenciamento de dashboards usando o site REST API.

Clique em em um resultado tab para view mais opções.

1. Clique em Editar para personalizar os resultados mostrados na visualização.

2. Clique em Delete para excluir os resultados tab.

3. Clique em Duplicate para clonar os resultados tab.

4. Clique em Adicionar ao painel para copiar a consulta e a visualização em um novo painel.

   • Essa ação cria um novo painel que inclui todas as visualizações associadas à consulta. Consulte Painéis para saber como editar seu painel.
   • Você será solicitado a escolher um nome para o novo painel. O novo painel é salvo em sua pasta home.
   • Você não pode adicionar resultados a um painel existente.

5. Clique em Add to legacy dashboard (Adicionar ao painel legado ) para adicionar os resultados tab a um painel legado novo ou existente.

6. Clique em qualquer uma das opções de download para fazer o download dos resultados. Consulte a descrição a seguir para obter detalhes e limites.

download de resultados : O senhor pode download os resultados como um arquivo CSV, TSV, ou Excel.

O senhor pode fazer o download de até aproximadamente 1 GB de dados de resultados do Databricks SQL em formato CSV e TSV e de até 100.000 linhas para um arquivo Excel.

O tamanho final do download do arquivo pode ser um pouco maior ou menor que 1 GB, pois o limite de 1 GB é aplicado a uma etapa anterior ao download final do arquivo.

nota

Se o senhor não conseguir download uma consulta, o administrador do workspace desativou o download para o seu workspace.

Execuções passadas

O senhor pode acessar view a execução anterior da consulta, inclusive a sintaxe completa da consulta. As execuções anteriores são abertas no modo somente leitura e incluem botões para clonar para uma nova consulta ou retomar a edição. Este tab não mostra a execução programada.

Explore os resultados

Os resultados da consulta retornados aparecem abaixo da consulta. O site Raw results tab é preenchido com as linhas retornadas. O senhor pode usar filtros integrados para reordenar os resultados por valores ascendentes ou descendentes. Você também pode usar o filtro para pesquisar linhas de resultados que incluam um valor específico.

O senhor pode usar a guia no painel de resultados para adicionar visualizações, filtros e parâmetros.

Filtre a lista de consultas salvas na janela de consultas

Na janela de consultas, você pode filtrar a lista de todas as consultas pela lista de consultas que você criou ( Minhas consultas ), por favoritos e por tags.

Automatize as atualizações

O senhor pode usar o botão programar para definir uma cadência automática para a execução da consulta. As atualizações automáticas podem ajudar a manter seus painéis e relatórios atualizados com os dados mais atuais. As consultas programadas também podem ativar o Databricks SQL alerta, um tipo especial de tarefa programada que envia notificações quando um valor atinge um limite especificado.

Consulte programar uma consulta.

Veja o que é Databricks SQL alerta?

Compartilhar consultas

O botão Share permite que o senhor compartilhe sua consulta com outros usuários em seu site workspace. Ao compartilhar, escolha entre as seguintes opções:

• execução como proprietário (credenciais do proprietário) : Essa configuração significa que os visualizadores podem ver os mesmos resultados da consulta que o proprietário da consulta. Isso se aplica à execução de consultas agendadas ou manuais.
• execução como visualizador (credenciais do visualizador) : Essa configuração limita os resultados às permissões atribuídas ao visualizador.

Consulte Configurar permissões de consulta.

Próxima etapa

Consulte Acessar e gerenciar consultas salvas para saber como trabalhar com consultas com a UI do Databricks.