Gravar consultas e explorar dados no novo editor do SQL

A interface do usuário do Databricks inclui um editor de 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 do SQL para gravar, executar, gerenciar e compartilhar consultas.

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

Abra o editor do SQL

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

O editor do SQL abre com 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 do SQL

Use o botão de alternância Novo editor SQL, à direita dos seletores suspensos de catálogo e de esquema, para habilitar o novo editor. Em exibições estreitas, você pode encontrar a alternância Novo editor SQL clicando no menu kebab à direita dos seletores de catálogo e esquema.

Habilite o novo editor para qualquer consulta que você possua:

• Clique em Novo editor SQL: OFF. Um menu pop-over Novo editor SQL é aberto.
  • A caixa de seleção Aplicar a todas as minhas consultas está marcada 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 a opção Novo editor SQL para ON.

O novo editor SQL não pode ser usado para todas as consultas. Você não pode alternar para o novo editor SQL para uma consulta se qualquer uma das seguintes condições for verdadeira:

• Você não é o proprietário da consulta.
• A consulta contém listas suspensas baseadas em consultas, 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 está vazio até que você execute a consulta.

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. Acesse o sistema de arquivos do workspace: você pode acessar e organizar seus objetos do workspace diretamente do editor SQL.
2. Use o Assistente do Databricks integrado: converse com o assistente para ajudá-lo a gravar, refinar ou entender consultas. Execute o código gerado pelo assistente no 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. Comentar no código: adicione comentários ao código para aprimorar a colaboração.
6. Revisar histórico de versões: revise as alterações recentes em sua consulta.

Conectar-se à computação

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

Quando você cria uma consulta pela primeira vez, a lista de SQL warehouses disponíveis é exibida em ordem alfabética. O último SQL warehouse usado será selecionado na próxima vez que você criar uma consulta. Se o workspace estiver habilitado para selecionar um SQL Warehouse padrão, você poderá personalizar seu warehouse padrão. Consulte Definir um warehouse padrão no nível do usuário.

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

• Executando
• Parado

O SQL warehouse selecionado será reiniciado automaticamente quando você executar a consulta. Consulte Iniciar um SQL warehouse para conhecer outras maneira de iniciar um SQL warehouse.

Procurar ativos e obter ajuda

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

Procurar arquivos do espaço de trabalho

Clique no no ícone da pasta para abrir a pasta de usuário do workspace. Você pode navegar por todos os arquivos de workspace aos quais você tem acesso a partir desta parte da interface do usuário.

Procurar objetos de dados

Se você tiver a permissão de leitura de metadados, o navegador de esquema no Editor SQL exibirá os bancos de dados e as tabelas disponíveis. Você também pode procurar objetos de dados no Explorador do Catálogo.

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

Clique em próximo à parte superior do navegador de esquema para atualizar o esquema. Você pode digitar na barra de pesquisa para filtrar ativos por nome. Clique no filtre o ícone 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 em um nome de tabela para mostrar as colunas nessa tabela.

Obter ajuda do Assistente do Databricks

Clique no 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 do Databricks.

Criar uma consulta

Você pode inserir texto para criar uma consulta no Editor SQL. Você pode inserir elementos do navegador de esquema para referenciar catálogos e tabelas.

1. Digite a consulta no editor de SQL.

   O Editor SQL dá suporte ao preenchimento automático. Conforme você digita, o preenchimento automático sugere preenchimentos. Por exemplo, se um preenchimento válido no local do cursor é uma coluna, o preenchimento automático sugere um nome de coluna. Se você digita select * from table_name as t where t., o preenchimento automático reconhece que t é um alias de table_name e sugere as colunas dentro de table_name. Você também pode usar o preenchimento automático para referenciar fragmentos de consulta.

   

2. (Opcional) Quando terminar a edição, clique em Salvar. 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.

Consulta de 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 dos seletores suspensos, juntamente 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 do SQL. Se um nome de tabela ou coluna incluir espaços, encapsule esses identificadores em backticks em 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 exibição 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 visualização de 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. Ele 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 workspace, consulte Criar uma exibição de métrica.

Todas as avaliações de medida devem ser encapsuladas na função MEASURE. Consulte measure a função de agregação.

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 Assistente do Databricks

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

Editar várias abas de consulta

Por padrão, o editor do SQL usa guias para que você possa abrir e editar várias consultas simultaneamente. Para abrir uma nova guia, clique em + e escolha Criar nova consulta ou Abrir consulta existente. Clique em Abrir consulta existente para ver uma lista de consultas. A aba For you oferece uma lista curada de sugestões com base em seus padrões de uso. Use a guia Todos para localizar qualquer consulta à qual você tenha acesso.

Executar uma consulta simples ou consultas de múltiplas instruções

Você pode escrever consultas múltiplas em uma única guia do editor de consultas. Para usar várias consultas em uma única guia, encerre cada consulta com um ponto-e-vírgula (;).

Para executar uma única consulta:

1. Selecione um SQL warehouse.
2. Realçar uma consulta no Editor SQL (se várias consultas estiverem 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.

Encerrar uma consulta

Para encerrar uma consulta enquanto ela estiver 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 execução.

Compartilhar uma consulta

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

Execução interativa: as consultas no novo editor SQL sempre são executadas usando credenciais Executar como visualizador. Os resultados da consulta podem ser acessados por 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 warehouse associado para executar consultas.

Configurações de credencial: As configurações de permissão para alertas herdados, fluxos de trabalho e painéis herdados são as mesmas do editor de SQL herdado. Dependendo de 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 ACLs de consulta 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 em linhas individuais de código para fazer perguntas ou adicionar sugestões.

Controle do código-fonte de uma consulta

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

Salvar uma consulta

O conteúdo da consulta no novo editor SQL é salvo automaticamente continuamente. 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.

Exibir os resultados da consulta SQL

Você pode comparar a saída de cada instrução com várias instruções de resultado. Ao executar várias instruções SQL em uma única janela de edição, você pode usar a interface do usuário no painel Saída próximo à parte inferior da tela para rolar pelos diferentes conjuntos de resultados.

Você pode explorar e interagir com 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 de tipos de visualização disponíveis.

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

• Clique em Baixar 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 redirecionar 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 pasta inicial.
   • Adicione ao painel existente: Adiciona sua consulta e visualizações associadas a um painel existente. Use o menu suspenso para escolher o painel ao qual o conjunto de dados e a visualização devem ser adicionados.

Baixar os resultados

Você pode baixar os resultados como um arquivo CSV ou Excel. Os downloads de CSV dão suporte a até aproximadamente 5 GB de dados. Clique na em uma guia de resultados para exibir as opções de download. O tamanho final do download do arquivo pode ser um pouco mais ou menor que 5 GB, já que o limite de 5 GB é aplicado a uma etapa anterior do que o download final do arquivo.

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 O ícone de filtro.
2. Insira texto para descrever o tipo de filtro que você deseja aplicar. Um filtro nomeado é aplicado ao conjunto de resultados.

Para editar um filtro:

1. Clique no nome do filtro.
2. Use os menus suspensos e os campos de texto para ajustar as configurações de 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 OR para adicionar um filtro adicional.

Adicionar parâmetros

Os parâmetros permitem limitar o conjunto de resultados substituindo valores em uma consulta em runtime. Confira Trabalhar com parâmetros de consulta para saber como aplicar parâmetros.

Alterações de sintaxe de parâmetro

As consultas escritas no editor SQL herdado que usam chaves duplas ({{}}) para marcar parâmetros devem ser modificadas para serem executadas no novo editor SQL. O novo editor SQL usa a mesma sintaxe de parâmetro que outras ferramentas do Databricks, como painéis de IA/BI, IA/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 prefixados com dois-pontos, por exemplo, :parameter_name.

Consulte Marcadores de parâmetro nomeados para obter a documentação do SQL referenece. Consulte Exemplos de sintaxe de parâmetro nomeado para obter exemplos de conversão de sintaxe de parâmetro do editor SQL clássico em marcadores de parâmetro nomeados.

Tipos de filtro com suporte

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

Usar atalhos de teclado

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

Desabilitar o novo editor do SQL

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

• Clique em Novo editor SQL: ATIVADO. Um menu pop-over Novo editor SQL é aberto.
• Defina a alternância Novo Editor SQL como OFF.
• Na caixa de diálogo de confirmação, opte por desabilitar o novo editor somente para a consulta ativa ou para todas as consultas qualificadas.
  • A opção Desabilitar para todas as consultas qualificadas está desmarcada. Mantenha essa configuração se quiser desabilitar o novo editor apenas para a consulta ativa.
  • Para desabilitar o novo editor SQL para todas as suas consultas, marque a caixa de seleção Desabilitar para todas as consultas qualificadas.

Os administradores do workspace podem desativar esse recurso no nível do workspace visitando o portal de visualização e pesquisando o editor do SQL. Consulte Gerenciar Versões Prévias do Azure Databricks.