Escreva consultas e explore dados no novo editor SQL

Importante

Este recurso está no Public Preview.

A interface do usuário do Databricks inclui um editor SQL que você pode usar para criar consultas, colaborar com colegas, procurar dados disponíveis e criar visualizações. Esta página explica como usar o editor SQL para escrever, executar, gerenciar e compartilhar consultas.

Este artigo explica como usar o novo editor SQL. Para saber mais sobre como trabalhar com o editor SQL herdado, consulte Escrever consultas e explorar dados no editor SQL herdado.

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, a página inicial do editor SQL será aberta.

Ativar o novo editor SQL

Use a alternância Novo editor SQL , à direita dos seletores suspensos de catálogo e esquema, para ativar o novo editor. Em monitores estreitos, você pode encontrar o botão Novo editor SQL clicando no menu kebab à direita dos seletores de catálogo e esquema.

Habilite o novo editor para qualquer consulta de sua propriedade:

• Clique em Novo editor SQL: OFF. Um menu popover Novo editor SQL é aberto.
  • A caixa de seleção Aplicar a todas as minhas consultas está selecionada por padrão. Mantenha essa configuração para habilitar o editor para todas as consultas que você possui.
  • Para habilitar o novo editor somente para a consulta ativa, desmarque a caixa de seleção Aplicar a todas as minhas consultas .
• Defina o alternador do Novo editor SQL para ON.

O novo editor SQL não pode ser usado para todas as consultas. Não é possível alternar para o novo editor SQL para uma consulta se qualquer uma das seguintes opções for verdadeira:

• Você não é o proprietário da consulta.
• A consulta contém listas de seleção com base na consulta, que não são suportadas. Consulte Trabalhar com parâmetros de consulta.

Quando você ativa o novo editor SQL, sua consulta é reaberta na nova interface do usuário. O conjunto de resultados fica vazio até que você execute a consulta.

Nota

Os resultados da consulta são compartilhados com todos os colaboradores e estão limitados a 64.000 linhas.

Orientação

Esta seção destaca as principais diferenças na interface do usuário e explica como localizar e usar os recursos disponíveis.

1. Acessar o sistema de arquivos do espaço de trabalho: você pode acessar e organizar seus objetos do espaço de trabalho diretamente do editor SQL.
2. Use o Databricks Assistant integrado: converse com o assistente para ajudá-lo a escrever, refinar ou entender consultas. Execute o código gerado pelo assistente a partir do painel lateral.
3. Recolher seções de código: Clique na seta de recolhimento à esquerda de um bloco de código para ocultar e expandir seletivamente as seções de código. Isso pode facilitar o trabalho com arquivos grandes.
4. Abra a paleta de comandos: a paleta de comandos inclui ações comuns, atalhos de teclado, temas personalizados e links para ajudá-lo a encontrar rapidamente o que precisa. Depois de abri-lo, use a barra de pesquisa para procurar ferramentas e atalhos específicos.
5. Comentário sobre o código: adicione comentários ao código para melhorar a colaboração.
6. Rever o histórico de versões: reveja as alterações recentes à sua consulta.

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.

Procure ativos e obtenha ajuda

Use o painel esquerdo no editor SQL para procurar arquivos de espaço de trabalho, exibir objetos de dados e obter ajuda do Databricks Assitant.

Procurar arquivos da área de trabalho

Clique em o ícone da pasta para abrir a pasta de usuário do espaço de trabalho. Você pode navegar por todos os arquivos do espaço de trabalho aos quais tem acesso a partir desta parte da interface do usuário.

Procurar objetos de dados

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, deve ligar-se ao sistema de computação com os privilégios apropriados. Consulte Governança de dados com o Azure Databricks.

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 digitar na barra de pesquisa para filtrar ativos por nome. Clique no ícone de filtro para filtrar objetos por tipo.

Clique no nome de um objeto no navegador para ver mais detalhes sobre o objeto. Por exemplo, clique em um nome de esquema para mostrar as tabelas nesse esquema. Clique no nome de uma tabela para mostrar as colunas dessa tabela.

Obtenha ajuda do Databricks Assistant

Clique no o ícone Assistente para abrir uma janela de chat com o Databricks Assistant. Clique em uma pergunta sugerida ou insira sua própria pergunta para interagir com o Assistente Databricks.

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. Você também pode usar o preenchimento automático para fazer referência a trechos de consulta.

   

2. (Opcional) Quando terminar de editar, clique em Guardar. Por padrão, a consulta é salva na pasta inicial do usuário. Para salvar a consulta em um local diferente, selecione a pasta de destino e clique em Mover.

Nota

Novas consultas são automaticamente nomeadas Nova consulta com o carimbo de data/hora de criação anexado no título. Por padrão, novas consultas criadas sem um contexto de pasta específico são criadas na pasta Rascunhos no diretório base. Quando novas consultas são salvas ou renomeadas, elas são removidas dos Rascunhos.

Consultar fontes de dados

Você pode identificar uma fonte de consulta usando um nome de tabela totalmente qualificado na própria consulta ou selecionando uma combinação de catálogo e esquema nos seletores suspensos junto com o nome da tabela na consulta. Um nome de tabela totalmente qualificado na consulta substitui os seletores de catálogo e esquema no editor SQL. Se o nome de uma tabela ou de uma coluna incluir espaços, envolva esses identificadores em backticks nas suas consultas SQL.

Os exemplos a seguir demonstram como consultar vários objetos semelhantes a tabelas que você pode armazenar em um catálogo.

Consultar uma tabela ou vista padrão

O exemplo a seguir consulta uma tabela do samples catálogo.

SELECT
  o_orderdate,
  o_orderkey,
  o_custkey,
  o_totalprice,
  o_shippriority
FROM
  samples.tpch.orders

Consultar uma vista métrica

O exemplo a seguir consulta uma exibição de métrica que usa uma tabela do catálogo de exemplos como sua origem. Avalia as três medidas listadas e agrega sobre Order Month e Order Status. Ele retorna resultados classificados por Order Month. Para criar uma exibição de métrica semelhante em seu espaço de trabalho, consulte Criar uma exibição de métrica.

A função MEASURE deve envolver todas as avaliações de medidas. Consulte a função agregada measure.

SELECT
 `Order Month`,
 `Order Status`,
 MEASURE(`Order Count`),
 MEASURE(`Total Revenue`),
 MEASURE(`Total Revenue per Customer`)
FROM
 orders_metric_view
GROUP BY ALL
ORDER BY 1 ASC;

Otimizar uma consulta com o Databricks Assistant

Clique no Ícone do assistente no lado direito do editor para obter ajuda e sugestões embutidas ao escrever consultas. O /optimize comando barra solicita que o Assistente avalie e otimize as consultas. Para obter mais informações, consulte Otimizar código Python, PySpark e SQL.

Editar vários separadores de consulta

Por padrão, o editor SQL usa guias para que você possa abrir e 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 uma lista de consultas. A guia Para você oferece uma lista selecionada de sugestões com base no seu uso. Use a guia Tudo para localizar qualquer consulta à qual você tenha acesso.

Executar uma única consulta ou consultas com várias instruções

Você pode escrever consultas de várias declarações em um único separador do editor. Para usar várias declarações de consulta em um único separador, termine cada declaração com um ponto-e-vírgula (;).

Para executar uma única consulta:

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

Por padrão, Executar todas as instruções e Limitar 1000 são selecionados.

• Para executar apenas a instrução ative, desmarque Executar todas as instruções.
• Se uma consulta for salva com a configuração Limitar 1000 , essa configuração se aplicará a todas as execuções de consulta. Para retornar todas as linhas (até 64.000), desmarque LIMIT 1000 no menu suspenso Executar (1000 ). Para especificar um limite diferente no número de linhas, adicione uma LIMIT cláusula na consulta. O número máximo de linhas retornadas em uma tabela é 64.000.

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 consulta Encerrar uma em execução.

Partilhar uma consulta

O novo editor SQL lida com permissões em duas partes:

Execução interativa: As consultas no novo editor SQL são sempre executadas usando as credenciais Executar como espectador. Os resultados da consulta são acessíveis a qualquer pessoa que tenha acesso à consulta. Os usuários com permissões CAN EDIT ou superiores podem modificar o rascunho da consulta compartilhada. Além disso, as edições não salvas são visíveis para qualquer pessoa com permissões CAN VIEW ou superiores. Os usuários devem ter pelo menos a permissão CAN USE no depósito associado para executar consultas.

Configurações de credenciais: As configurações de permissão para alertas herdados, fluxos de trabalho e painéis herdados são as mesmas do editor SQL herdado. Dependendo das suas preferências, esses ativos podem ser executados usando as credenciais do proprietário ou do visualizador.

Consulte Configurar permissões de consulta para saber mais sobre as configurações de credenciais Executar como proprietário e Executar como visualizador . Consulte Consultar ACLs para saber como gerenciar o acesso ao objeto de consulta.

Colabore em consultas em tempo real

Depois de compartilhar a consulta, você pode cocriar ou depurar consultas ao vivo por meio da edição colaborativa. Os editores também podem comentar linhas individuais de código para fazer perguntas ou adicionar sugestões.

controle do código-fonte uma consulta

Os arquivos de consulta SQL do Databricks (extensão: .dbquery.ipynb) são suportados nas pastas Databricks Git. Você pode usar uma pasta Git para controlar seus arquivos de consulta e compartilhá-los em outros espaços de trabalho com pastas Git que acessam o mesmo repositório Git. Se você optar por desativar o novo editor SQL depois de confirmar ou clonar uma consulta em uma pasta Databricks Git, exclua e reclone essa pasta Git para evitar comportamentos inesperados.

Guardar uma consulta

O conteúdo da consulta no novo editor SQL é continuamente salvo automaticamente. O botão Salvar controla se o conteúdo da consulta de rascunho deve ser aplicado a ativos relacionados, como painéis herdados, fluxos de trabalho ou alertas herdados. Se a consulta for compartilhada com a credencial Executar como proprietário , somente o proprietário da consulta poderá usar o botão Salvar para propagar as alterações. Se a credencial estiver definida como Executar como visualizador, qualquer usuário com pelo menos CAN MANAGE permissão poderá salvar a consulta.

Ver resultados da consulta

Você pode comparar a saída de cada instrução com várias instruções de resultado. Ao executar várias instruções SQL a partir de uma única janela de edição, você pode usar a interface do usuário no painel Output perto da parte inferior da tela para percorrer os diferentes conjuntos 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 os resultados.

Visualizações

Clique no para adicionar uma 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.

Clique no em uma guia de visualização para mostrar opções adicionais.

• Clique em Download para baixar os dados representados na visualização como um arquivo CSV, TSV ou Excel.
• Clique em Remover para excluir a visualização.
• Clique em Duplicar para clonar a guia de resultados.
• Clique em Renomear para renomear a visualização.

1. Clique em Editar para editar a visualização.

2. Clique em Adicionar ao painel para copiar a consulta e a visualização para um novo painel de IA/BI.

3. Selecione Criar novo painel ou Adicionar ao painel existente.

   • Crie um novo painel: Cria um novo painel que inclui todas as visualizações associadas à consulta. Você será solicitado a escolher um nome para o novo painel. O novo painel é salvo na sua pasta pessoal.
   • Adicionar ao painel existente: Adiciona sua consulta e visualizações associadas a um painel existente. Use o menu dropdown para escolher o painel ao qual o conjunto de dados e a visualização devem ser adicionados.

Resultados do download

Você pode baixar os resultados como um arquivo CSV ou Excel. Os downloads CSV suportam até aproximadamente 5 GB de dados. Clique no numa guia de resultados para ver as opções de download. O tamanho final do download do arquivo pode ser um pouco maior ou menor que 5 GB, pois o limite de 5 GB é 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.

Filtros

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. Use o Assistente para ajudá-lo a adicionar um filtro para resultados.

Para adicionar um filtro:

1. Clique no
2. Introduza texto para descrever o tipo de filtro que pretende aplicar. Um filtro nomeado é aplicado ao conjunto de resultados.

Para editar um filtro:

1. Clique no nome do filtro.
2. Utilize os menus suspensos e os campos de texto para ajustar as configurações do filtro.
3. (Opcional) Selecione Sensível a maiúsculas e minúsculas para tornar o filtro sensível a maiúsculas e minúsculas.
4. (Opcional) Clique em Adicionar condição OU para adicionar um filtro adicional.

Adicionar parâmetros

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.

Alterações na sintaxe dos parâmetros

As consultas escritas no editor SQL antigo que usam chaves duplas ({{}}) para marcar parâmetros devem ser adaptadas para funcionar no novo editor SQL. O novo editor SQL usa a mesma sintaxe de parâmetros que outras ferramentas Databricks, como painéis de IA/BI, AI/BI Genie e notebooks.

Os parâmetros no novo editor SQL são definidos usando a sintaxe de parâmetro nomeado. Parâmetros nomeados são parâmetros em uma consulta que são prefixados com dois pontos, por exemplo, :parameter_name.

Consulte Marcadores de parâmetros nomeados para obter a documentação de referência SQL. Consulte Exemplos de sintaxe de parâmetros nomeados para obter exemplos de conversão de sintaxe de parâmetros do editor SQL clássico para marcadores de parâmetros nomeados.

Tipos de fiilter suportados

A tabela a seguir mostra os tipos de filtro suportados no novo editor SQL. A segunda coluna indica se o filtro também funciona no editor SQL herdado.

Tipo de filtro	Suportado no editor legado
É igual a	Sim
Não é igual a	Não
É um dos	Sim
Não é um dos	Não
Contém	Sim
Não contém	Não
Começa com	Sim
Não começa com	Não
Termina com	Não
Não termina com	Não
É nulo	Não
Não é nulo	Não
Maior que	Não
Maior ou igual a	Não
Menos de	Não
Menor que ou igual a	Não
Entre	Sim
Antes	Não
Depois	Não
É verdade	Sim
É falso	Sim
Condições OU	Não

Usar atalhos de teclado

O novo editor SQL inclui muitos atalhos de teclado internos para ajudá-lo a trabalhar rapidamente. A tabela a seguir identifica os atalhos de teclado mais usados.

Função	Atalho do macOS	Atalho do Windows
Executar uma consulta	Cmd + Enter	Ctrl + Enter
Executar uma única instrução realçada	Cmd + Shift + Enter	Ctrl + Shift + Enter
Preenchimento Automático	Ctrl + Space	Ctrl + Space
Aumentar o tamanho do tipo de letra	Option + + (chave mais)	Alt + + (chave mais)
Diminuir o tamanho da fonte	Option + - (tecla menos)	Alt + - (tecla menos)
Formatar código SQL	Cmd + Shift + F	Ctrl + Shift + F
Ver todos os atalhos	Esc então H	Esc então H

Desativar o novo editor SQL

Para desativar o novo editor SQL, use as seguintes etapas:

• Clique em Novo editor SQL: ATIVADO. Um menu popover Novo editor SQL é aberto.
• Defina o Novo Editor SQL alternar para OFF.
• Na caixa de diálogo de confirmação, opte por desativar o novo editor apenas para a consulta ativa ou para todas as consultas elegíveis.
  • A opção Desativar para todas as consultas qualificadas está desmarcada. Mantenha essa configuração se quiser desabilitar o novo editor apenas para a consulta ativa.
  • Para desativar o novo editor SQL para todas as suas consultas, marque a caixa de seleção Desabilitar para todas as consultas qualificadas.

Os administradores do espaço de trabalho podem desativar a visualização no nível do espaço de trabalho visitando o portal de visualização. Consulte Gerenciar visualizações do Azure Databricks.