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 o list, insira texto na caixa de texto.

Na primeira vez que crias uma consulta, a list de armazéns SQL disponíveis é exibida 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

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 tiver permissão de leitura de metadados, o navegador schema no editor SQL mostrará as bases de dados disponíveis e tables. Você também pode procurar objetos de dados do Catalog Explorer.

Você pode navegar pelos objetos de banco de dados governados pelo Unity Catalogno Catalog Explorer sem atividade computacional ativa. Para explorar dados no hive_metastore e outros catalogs não regidos pelo Unity Catalog, você deve anexar à computação com privilégios apropriados. Veja Governança de dados com o Unity Catalog.

Clique no ícone no topo do navegador de schema para refresh o schema. Você pode filtrar o schema digitando cadeias de caracteres de filtro na caixa de pesquisa.

Clique num nome de table para exibir o columns desse table.

Criar uma consulta

Você pode inserir texto para criar uma consulta no editor SQL. Você pode insert elementos do navegador schema para fazer referência a catalogs e tables.

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 um column, o preenchimento automático sugere um nome de column. Se você digitar select * from table_name as t where t., o preenchimento automático reconhecerá que t é um alias para table_name e sugerirá o columns dentro 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 select 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 schema, identificadores de sintaxe de consulta (como SELECT e JOIN) e os títulos de trechos de consulta. Ele está ativado por padrão, a menos que o banco de dados schema exceda cinco mil tokens (tables ou columns).

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.

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, selectCriar nova consulta ou Abrir consulta existente. Clique em Abrir consulta existente para ver a sua lista list de consultas guardadas. clique em Minhas Consultas ou Favoritos para filtrar a list 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. Select 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 um table no painel de resultados.

   

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 selectMover para a Lixeira.
• Clique em Mover para a lixeira para confirmar.

Para restore uma consulta da lixeira:

1. Na listTodas 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.

Set descrição da consulta e exibir informações da consulta

Para set 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 adicionar aos favoritos uma consulta, clique na estrela à esquerda do título em listConsultas . 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 aparece na caixa de texto where 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.

Remove 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 remove.
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. O Novo resultado table é ON para novas consultas. Se necessário, clique na lista suspensa para desativá-la. As imagens nesta seção usam o novo resultado table.

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 parameters

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 resultado set. Consulte Tipos de visualização para obter uma list completa dos tipos de visualização disponíveis.

Filtro: Os filtros permitem-lhe limit o resultado set 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: Parameters permitem limit o resultado set substituindo values na consulta durante a execução. Consulte Trabalhar com a parameters para aprender a aplicar parameters.

Editar, baixar ou adicionar a um painel

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 limit de 1GB é aplicado a uma etapa anterior ao download do arquivo final.

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 valuesascendente ou decrescente. 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 parameters.

Filtrar o list na window de consultas guardadas

Nas consultas window, você pode filtrar o list de todas as consultas pelo list de consultas que você criou (Minhas Consultas), por favoritos e por tags.

Automatizar as atualizações

Você pode usar o botão Agendar para set uma cadência automática para a execução de consultas. 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 (credentialsdo proprietário): Esta definiçã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 (visualizadores credentials): Esta configuração limita os resultados às permissões atribuídas pelo 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.