Escrever consultas no novo editor SQL

Esta página explica como se ligar a um SQL warehouse, navegar por ficheiros e dados, e escrever consultas no novo editor SQL do Databricks.

Conectar-se à computação

Você deve ter pelo menos permissões CAN USE em um SQL warehouse para executar consultas. Pode usar a lista suspensa no topo do editor para ver as opções disponíveis. Para filtrar a lista, introduza texto na caixa de pesquisa.

Se tiveres um SQL warehouse predefinido, o editor SQL usa-o automaticamente quando crias uma consulta. Se não estiver definido um armazém por defeito, seleciona de uma lista alfabética de armazéns disponíveis. As consultas subsequentes utilizam o último armazém selecionado. Para definir um armazém predefinido, veja Definir um armazém predefinido ao nível do utilizador.

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

• Em execução
• Parou

Note

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 de dados SQL para saber outras formas de iniciar um armazém de dados SQL.

Procure ativos e obtenha ajuda

Use o painel esquerdo do editor SQL para encontrar ficheiros de workspace, visualizar objetos de dados e obter ajuda do Genie Code.

Procurar arquivos da área de trabalho

Clique em o ícone da pasta para abrir a pasta de usuário do espaço de trabalho. Podes ir a todos os ficheiros de espaço de trabalho a que tens acesso a partir desta parte da interface.

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. Veja Governação de dados com Azure Databricks.

Note

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. Pode inserir texto na barra de pesquisa para filtrar os 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.

Peça ajuda ao Código Genio

Clique Ícone do Código Genio para abrir uma janela de chat com o Código Genio. Clique numa pergunta sugerida ou introduza a sua própria pergunta para interagir com o Código Génio.

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. Introduza a 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 defeito, a consulta é guardada na pasta Home do utilizador. Para salvar a consulta em um local diferente, selecione a pasta de destino e clique em Mover.

Note

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.

Note

O número máximo de resultados retornados em uma tabela é de 64.000 linhas ou 10MB, o que for menor.

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 vista métrica semelhante no seu espaço de trabalho, veja Tutorial: Construa uma vista métrica integrada com joins.

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;

Otimize uma consulta com o Genie Code

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 mais informações, consulte Otimizar Python, PySpark e código 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.

Guardar uma consulta

O conteúdo da consulta no novo editor SQL é continuamente salvo automaticamente. O botão Guardar controla se o conteúdo da consulta preliminar deve ser aplicado a ativos relacionados, como fluxos de trabalho ou alertas legados. 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.

Controlo de versões 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.