Escreva consultas e explore dados no editor SQL

A interface do usuário do Azure Databricks inclui um editor SQL que você pode usar para criar consultas, procurar dados disponíveis e criar visualizações. Você também pode compartilhar suas consultas salvas com outros membros da equipe no espaço de trabalho. Este artigo explica como usar o editor SQL para escrever, executar e gerenciar consultas. Uma nova versão do editor SQL está em Visualização Pública. Para saber como habilitar e trabalhar com o novo editor SQL, consulte Colaborar com colegas usando o novo editor SQL.

Depois de abrir o editor, você 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.

Você pode abrir várias consultas usando as guias de consulta na parte superior do editor de texto. Cada guia de consulta tem controles para executar a consulta, marcar a consulta como favorita e conectar-se a um SQL warehouse. Você também pode Salvar, Agendar ou Compartilhar consultas.

Abra o editor SQL

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

O editor SQL abre para a sua última consulta aberta. Se nenhuma consulta existir, ou todas as suas consultas tiverem sido fechadas explicitamente, uma nova consulta será aberta. Ele é automaticamente chamado de Nova Consulta e o carimbo de data/hora de criação é anexado no título.

Conectar-se à computação

Você deve ter pelo menos permissões CAN USE em um SQL warehouse em execução para executar consultas. Você pode usar a lista suspensa perto da parte superior do editor para ver as opções disponíveis. Para filtrar a lista, introduza texto na caixa de texto.

Na primeira vez que você 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 você criar uma consulta.

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

• Em execução
• Início
• Parou

Nota

Se não houver armazéns SQL na lista, entre em contato com o administrador do espaço de trabalho.

O SQL warehouse selecionado será reiniciado automaticamente quando você executar a consulta. Consulte Iniciar um armazém SQL para saber outras formas de iniciar um armazém SQL.

Procurar objetos de dados no editor SQL

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

Você pode navegar pelos objetos de banco de dados controlados pelo Catálogo Unity no Catalog Explorer sem computação ativa. Para explorar dados no hive_metastore e em outros catálogos não regidos pelo Unity Catalog, você deve anexar à computação com privilégios apropriados. Consulte Governança de dados com o Unity Catalog.

Nota

Se não existirem objetos de dados no navegador de esquema ou no Gerenciador de Catálogos, entre em contato com o administrador do espaço de trabalho.

Clique perto da parte superior do navegador de esquema para atualizar o esquema. Você pode filtrar o esquema digitando cadeias de caracteres de filtro na caixa de pesquisa.

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

Criar uma consulta

Você pode inserir texto para criar uma consulta no editor SQL. Você pode inserir elementos do navegador de esquema para fazer referência a catálogos e tabelas.

1. Digite sua consulta no editor SQL.

   O editor SQL suporta preenchimento automático. À medida que você digita, o preenchimento automático sugere conclusão. Por exemplo, se uma conclusão válida 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 reconhece que t é um alias para table_name e sugere as colunas dentro do table_name.

   

2. (Opcional) Quando terminar de editar, clique em Guardar. Por padrão, a consulta é salva na pasta inicial do usuário ou você pode selecionar um local diferente. Em seguida, clique em Guardar.

Ativar e desativar o preenchimento automático

O preenchimento automático dinâmico pode concluir tokens de esquema, identificadores de sintaxe de consulta (como SELECT e JOIN) e os títulos de trechos de consulta. Ele é habilitado por padrão, a menos que seu esquema de banco de dados exceda cinco mil tokens (tabelas ou colunas).

Use a alternância abaixo do editor SQL para desativar ou ativar o preenchimento automático ao vivo.

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

Guardar consultas

O botão Salvar , no canto superior direito do editor SQL, salva sua consulta.

Importante

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

Editar várias consultas

Por padrão, o editor SQL usa guias para que você possa editar várias consultas simultaneamente. Para abrir um novo separador, clique em e, em seguida, selecione +Criar nova consulta ou Abrir consulta existente. Clique em Abrir consulta existente para ver a lista de consultas guardadas. clique em Minhas Consultas ou Favoritos para filtrar a lista de consultas. Na linha que contém a consulta que pretende visualizar, clique em Abrir.

Executar uma única consulta ou várias consultas

Para executar uma consulta ou todas as consultas:

1. Selecione um armazém SQL.

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

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

   

Nota

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

Encerrar uma consulta

Para encerrar uma consulta enquanto ela está em execução, clique em Cancelar. Um administrador pode interromper uma consulta em execução iniciada por outro usuário exibindo a opção Encerrar uma consulta em execução.

Opções de consulta

Você pode usar o menu de contexto kebab perto da parte superior do editor de consultas para acessar as opções do menu para clonar, reverter, formatar e editar informações de consulta.

Reverter para consulta salva

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

Descartando e restaurando consultas

Para mover uma consulta para a lixeira:

• Clique no menu de contexto do kebab ao lado da consulta no editor SQL e selecione Mover para a Lixeira.
• Clique em Mover para a lixeira para confirmar.

Para restaurar uma consulta a partir da reciclagem:

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

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

Para definir uma descrição da 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, introduza a sua descrição. Em seguida, clique em Guardar. Você também pode exibir o histórico da consulta, incluindo quando ela foi criada e atualizada, nesta caixa de diálogo.

Consultas favoritas e de tags

Você pode usar favoritos e tags para filtrar as listas de consultas e painéis exibidos na página de destino do espaço de trabalho e em cada uma das páginas de listagem para painéis e consultas.

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

Tags: Você pode marcar consultas e painéis com qualquer string significativa para sua organização.

Adicionar uma etiqueta

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. É apresentada uma caixa de diálogo Informações da consulta .

2. Se a consulta não tiver tags aplicadas, Adicionar algumas tags será exibido 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 em X em qualquer tag que você deseja remover.
3. Clique em Salvar para fechar a caixa de diálogo.

Ver resultados da consulta

Depois que uma consulta é executada, os resultados aparecem no painel abaixo dela. A tabela Novos resultados está ATIVADA para novas consultas. Se necessário, clique na lista suspensa para desativá-la. 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 os seguintes recursos para explorar resultados:

Visualizações, filtros e parâmetros

Clique no para adicionar uma visualização, filtro ou parâmetro. São apresentadas as seguintes opções:

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 limitar 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, baixar ou adicionar a um painel

Importante

• A Databricks recomenda o uso de painéis de IA/BI (anteriormente Lakeview dashboards). Versões anteriores de painéis, anteriormente conhecidos como painéis SQL Databricks, agora são chamados de painéis herdados. O Databricks não recomenda a criação de novos painéis herdados.
• Converta painéis herdados usando a ferramenta de migração ou a API REST. Consulte Clonar um painel herdado em um painel de IA/BI para obter instruções sobre como usar a ferramenta de migração interna. Consulte Tutoriais de painel para obter tutoriais sobre como criar e gerenciar painéis usando a API REST.

Clique na guia de resultados para ver mais opções.

1. Clique em Editar para personalizar os resultados mostrados na visualização.
2. Clique em Excluir para excluir a guia de resultados.
3. Clique em Duplicar para clonar a guia de resultados.
4. Clique em Adicionar ao painel para copiar a consulta e a visualização para 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 na sua pasta pessoal.
   • Não é possível adicionar resultados a um painel existente.
5. Clique em Adicionar ao painel herdado para adicionar a guia de resultados a um painel herdado novo ou existente.
6. Clique em qualquer uma das opções de download para baixar os resultados. Consulte a descrição a seguir para obter detalhes e limites.

Resultados do download: você pode baixar os resultados como um arquivo CSV, TSV ou Excel.

Você pode baixar até aproximadamente 1 GB de dados de resultados do Databricks SQL em formato CSV e TSV e até 100.000 linhas para um arquivo do Excel.

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

Nota

Se não conseguir transferir uma consulta, o administrador da área de trabalho desativou a transferência da área de trabalho.

Execuções passadas

Você pode exibir execuções anteriores para a consulta, incluindo a sintaxe de consulta completa. As execuções anteriores são abertas no modo somente leitura e incluem botões para Clonar para nova consulta ou Retomar edição. Esta guia não mostra execuções agendadas.

Explore os resultados

Os resultados da consulta retornados aparecem abaixo da consulta. A guia Resultados brutos é preenchida com as linhas retornadas. Você pode usar filtros internos para reordenar os resultados por valores crescentes ou decrescentes. Você também pode usar o filtro para pesquisar linhas de resultados que incluam um valor específico.

Você pode usar guias no painel de resultados para adicionar visualizações, filtros e parâmetros.

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

Automatizar as atualizações

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

Consulte Agendar uma consulta.

Consulte O que são alertas Databricks SQL?.

Partilhar consultas

O botão Partilhar permite-lhe partilhar a sua consulta com outros utilizadores na sua área de trabalho. Ao compartilhar, escolha uma das seguintes opções:

• Executar 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 a execuções de consultas agendadas ou manuais.
• Executar como visualizador (credenciais de visualizador): essa configuração limita os resultados às permissões atribuídas ao visualizador.

Consulte Configurar permissões de consulta.

Próximo passo

Consulte Acessar e gerenciar consultas salvas para saber como trabalhar com consultas com a interface do usuário do Azure Databricks.