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.
Selecionar uma base de dados
As consultas são executadas no contexto de um banco de dados. Você pode alterar o banco de dados associado 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 diferentes tipos, incluindo um banco de dados KQL ou um banco de dados de um cluster do Azure Data Explorer.
Selecione a guia que corresponde ao tipo de banco de dados desejado.
No painel de conexão no lado esquerdo da página de consulta, em Explorer, selecione V para expandir o menu de conexões de banco de dados.
Em Conectar origem, 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 do hub dedados do OneLake e use o menu +Adicionar fonte de dados para se conectar a uma fonte de dados diferente.
Uma lista de tabelas associadas a esse banco de dados aparece abaixo do nome do banco de dados no painel de conexões.
Interagir com bancos de dados usando o painel de conexão
O painel de conexão permite navegar e alternar entre os bancos de dados conectados ao conjunto de consultas. No painel de conexão, em Banco de dados, selecione V para expandir o menu de conexões de banco de dados. Selecione o banco de dados que deseja explorar. O painel de conexão mostra um detalhamento dos seguintes itens incluídos no banco de dados selecionado:
- Tabelas
- Vista Materializada
- Atalhos
- Funções
No painel de conexão, você pode explorar quais itens estão incluídos em cada seção. Para abrir o menu de ações, passe o mouse sobre o item e selecione o menu Mais [...]. O menu oferece opções para:
- Atualizar dados
- Ver perfil de dados
- Inserir para criar um script e colá-lo no editor de consultas
- Eliminar
Diferentes ações estão disponíveis para diferentes tipos de itens.
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 um dos bancos de dados aos 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.
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 estados diferentes.
- Adicionar um novo separador: selecione o sinal de adição + à direita dos separadores existentes. Diferentes guias podem ser conectadas a diferentes bancos de dados.
- Renomear uma guia: selecione o ícone de lápis ao lado do nome da guia.
- Alterar posições de tabulação: altere as posições de tabulação usando gestos de arrastar e soltar.
- Alterar a conexão de banco de dados existente: em Explorer, selecione a conexão de banco de dados existente para abrir o hub de dados.
No lado direito da barra de comandos, há um menu com ações adicionais para gerenciar as várias guias em seu conjunto de consultas.
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 tabela acima.
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.
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.
