Consultar dados em um conjunto de consultas KQL
Neste artigo, você aprenderá a usar um conjunto de consultas KQL. O conjunto de consultas KQL é o item usado para executar consultas, exibir e personalizar resultados de consultas em dados de diferentes fontes de dados, como Eventhouse, banco de dados KQL e muito mais.
O KQL Queryset usa a Kusto Query Language para criar consultas e também suporta muitas funções SQL. Para obter mais informações sobre a linguagem de consulta, consulte Visão geral da linguagem de consulta Kusto.
Pré-requisitos
- Um espaço de trabalho com uma capacidade habilitada para Microsoft Fabric
- Um banco de dados KQL com permissões de edição e dados ou um cluster e banco de dados do Azure Data Explorer com permissões AllDatabaseAdmin.
Selecione uma fonte de dados
As consultas são executadas no contexto de uma fonte de dados. Você pode alterar a fonte de dados associada a qualquer momento e manter as consultas salvas no editor de consultas. Você pode associar seu conjunto de consultas KQL a várias fontes de dados de tipos diferentes, incluindo um banco de dados KQL ou uma fonte de dados de um cluster do Azure Data Explorer.
Selecione a guia que corresponde ao tipo de fonte de dados desejado.
No painel no lado esquerdo da página de consulta, em Explorer e na barra de pesquisa, use o alternador de banco de dados para expandir o menu de conexões da fonte de dados.
Selecione Adicionar fonte de dadose, em seguida, selecione hub de dados OneLake.
Na janela do hub de dados OneLake exibida, selecione um banco de dados KQL para se conectar ao seu conjunto de consultas KQL e selecione Conectar. Como alternativa, feche a janela
hub de dados OneLake e use o menu + Adicionar fonte de dados para se conectar a uma fonte de dados diferente.
Uma lista de tabelas associadas a essa fonte de dados aparece abaixo do nome da fonte de dados.
Escrever uma consulta
Agora que você está conectado à sua fonte de dados, pode executar consultas nesses dados. O KQL Queryset usa a Kusto Query Language (KQL) para consultar dados de qualquer uma das fontes de dados às quais você tem acesso. Para saber mais sobre o KQL, consulte Visão geral da linguagem de consulta Kusto.
Os exemplos a seguir usam dados que estão disponíveis publicamente em https://kustosamples.blob.core.windows.net/samplefiles/StormEvents.csv.
Escreva ou copie uma consulta no painel superior do conjunto de consultas KQL.
Selecione o botão Executar ou pressione Shift+Enter para executar a consulta.
A saída da consulta resultante é exibida na grade de resultados, que aparece abaixo do painel de consulta. Observe a verificação verde indicando que a consulta foi concluída com êxito e o tempo usado para calcular os resultados da consulta.
Interaja com fontes de dados
O explorador de fontes de dados permite alternar entre as fontes de dados conectadas à guia do conjunto de consultas em que você está.
Na parte superior do painel do explorador da fonte de dados, em Explorer você pode usar a barra de pesquisa para pesquisar uma fonte de dados específica. Você também pode usar o alternador de banco de dados abaixo da barra de pesquisa para expandir o menu de conexões da fonte de dados. Selecione a fonte de dados que deseja usar. Se o nome do separador não tiver sido editado anteriormente, ele recebe automaticamente o nome da fonte de dados.
O painel do explorador da fonte de dados tem duas seções. A seção superior lista todos os itens na fonte de dados e a seção inferior mostra todas as fontes de dados disponíveis no conjunto de consultas.
Itens na fonte de dados
A seção superior do explorador da fonte de dados mostra todos os itens incluídos na fonte de dados que você está usando.
- Tabelas
- Vista Materializada
- Atalhos
- Funções
Selecione a seta > à esquerda do item que deseja expandir. Você pode fazer uma busca detalhada para mostrar mais detalhes selecionando a seta > à esquerda dos itens nos níveis de lista subsequentes. Por exemplo, em Tabelas, selecione a seta > à esquerda de uma tabela para mostrar a lista das colunas nessa tabela.
Para abrir o menu de ações, passe o mouse sobre um item na lista expandida e selecione o menu Mais ações [...]. O menu mostra as seguintes opções:
- Atualizar banco de dados
- Ver perfil de dados
- Inserir: para criar e copiar um script
- Obter dados: para adicionar uma nova fonte de dados
- Criar um painel
- Excluir tabela
Diferentes ações estão disponíveis para diferentes tipos de itens.
Fontes de dados disponíveis
A seção inferior do explorador de fontes de dados mostra todas as fontes de dados disponíveis que foram adicionadas ao conjunto de consultas.
Para abrir o menu de ações, passe o mouse sobre o nome da fonte de dados e selecione o menu
- Atualizar banco de dados
- Use esta base de dados: mude para usar esta fonte de dados no separador atual
- Consulta em uma nova guia: abra esta fonte de dados em uma nova guia no conjunto de consultas
- Remover origem: remove todos os bancos de dados dessa fonte de dados
- Remover banco de dados: remove somente o banco de dados selecionado
Copiar consulta
Talvez você queira copiar e compartilhar as consultas criadas.
Na parte superior da janela de consulta, selecione a guia Página Inicial .
No painel de consulta, selecione Copiar consulta.
A tabela a seguir descreve as muitas opções de como copiar uma consulta.
Ação Descrição Copiar consulta Copie o texto da consulta. Link para a área de transferência Copie um link profundo que pode ser usado para executar a consulta. Vincular e consultar a área de transferência Copie um link que pode ser usado para executar a consulta e o texto da consulta. Ligação, consulta e resultados para a área de transferência Copie um link que possa ser usado para executar a consulta, o texto da consulta e os resultados da consulta. Copiar resultados Copie os resultados da consulta. Selecione a ação desejada na lista.
Cole essas informações para editá-las ou compartilhá-las, por exemplo, no Microsoft Word, Microsoft Teams ou Outlook.
Importante
O usuário que está recebendo o link de consulta deve ter permissões de exibição para os dados subjacentes para executar a consulta e exibir os resultados.
Gerir separadores do conjunto de consultas
Dentro de um conjunto de consultas KQL, você pode criar várias guias. Cada guia pode ser associada a um banco de dados KQL diferente e permite que você salve consultas para uso posterior ou compartilhe com outras pessoas para colaborar na exploração de dados. Você também pode alterar o banco de dados KQL associado a qualquer guia, permitindo que você execute a mesma consulta em dados em bancos de dados diferentes.
Pode gerir os separadores das seguintes formas:
- Alterar a conexão da fonte de dados existente: Em Explorer e na barra de pesquisa, use o alternador de banco de dados para expandir o menu Conexões da fonte de dados.
- Renomeie uma guia: Ao lado do nome da guia, selecione o ícone de lápis .
- Adicionar um novo separador: À direita dos separadores existentes na barra de comandos, selecione o símbolo de adição +. Diferentes guias podem ser conectadas a diferentes fontes de dados.
- Mais ações: No lado direito da barra de comandos, há um menu de guias com mais ações para gerenciar as várias guias em seu conjunto de consultas.
- Alterar posições de tabulação: Use gestos de arrastar e soltar.
Exportar dados de consulta como CSV
Em vez de simplesmente copiar e colar a saída da consulta, você também pode exportar os resultados da consulta.
Este é um método único para exportar um arquivo CSV contendo os resultados da consulta.
Na parte superior da janela de consulta, selecione a guia Página Inicial .
No painel de consulta, selecione Exportar para CSV.
Salve o arquivo CSV localmente.
Excluir conjunto de consultas KQL
Para excluir seu conjunto de consultas KQL:
Selecione o espaço de trabalho no qual seu conjunto de consultas KQL está localizado.
Passe o cursor sobre o conjunto de consultas KQL que deseja excluir. Selecione Mais [...] e, em seguida, selecione Eliminar.
