Consultar dados em um conjunto de consultas KQL
Nesse artigo, você aprenderá a usar um conjunto de consultas KQL. O conjunto de consultas KQL é o item usado para executar consultas, exibir e personalizar os resultados da consulta em dados de diferentes fontes de dados, como Eventhouse, banco de dados KQL e muito mais.
O conjunto de consultas KQL usa a Linguagem de Consulta Kusto para criar consultas e oferece suporte a muitas funções SQL. Para saber mais 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 o Microsoft Fabric
- Um banco de dados KQL com permissões e dados de edição ou um cluster e banco de dados do Azure Data Explorer com permissões AllDatabaseAdmin.
Selecionar 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 diferentes tipos, 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 à esquerda da página de consulta, em Explorer e na barra de pesquisa, use o comutador de banco de dados para expandir o menu de conexões da fonte de dados.
Selecione Adicionar fonte de dados, então selecione hub de dados OneLake.
Na janela do Hub de dados do OneLake que é exibida, selecione um banco de dados KQL para se conectar ao conjunto de consultas KQL. Como alternativa, feche a janela do 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.
Escreva uma consulta
Agora que você está conectado à fonte de dados, pode executar consultas nesses dados. O conjunto de consultas KQL usa a KQL (Linguagem de Consulta Kusto) para consultar dados de qualquer uma das fontes de dados às quais você tem acesso. Para saber mais sobre KQL, consulte Visão geral do KQL (Linguagem de Consulta Kusto).
Os exemplos a seguir usam dados 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 marca de seleção verde indicando que a consulta foi concluída com sucesso e o tempo usado para calcular os resultados da consulta.
Interagir com fontes de dados
O gerenciador 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 gerenciador de fontes de dados, em Explorer você pode usar a barra de pesquisa para procurar uma fonte de dados específica. Você também pode usar o comutador 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 você deseja usar. Se o nome da guia não tiver sido editado anteriormente, ele será automaticamente nomeado em homenagem à fonte de dados.
O painel do gerenciador de fontes 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 gerenciador de fontes de dados mostra todos os itens incluídos na fonte de dados que você está usando.
- Tabelas
- Visão Materializada
- Atalhos
- Funções
Selecione a seta > à esquerda do item que você deseja expandir. Você pode fazer drill down 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ção, 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
- Exibir perfil de dados
- Inserir: para criar e copiar um script
- Obter dados: para adicionar uma nova fonte de dados
- Criar um painel
- Excluir tabela
Ações diferentes estão disponíveis para diferentes tipos de item.
Fontes de dados disponíveis
A seção inferior do gerenciador 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ção, passe o mouse sobre o nome da fonte de dados e selecione o menu Mais ações [...]. O menu mostra as seguintes opções:
- Atualizar banco de dados
- Use este banco de dados: mude para usar essa fonte de dados na guia atual
- Consulta em uma nova guia: abra essa fonte de dados em uma nova guia no conjunto de consultas
- Remover fonte: exclui todos os bancos de dados nessa fonte de dados
- Remover banco de dados: remove apenas o banco de dados selecionado
Copiar consulta
Talvez você queira copiar ou compartilhar as consultas criadas.
Na parte superior da janela de consulta, selecione a guia Início.
No painel de consulta, selecione Copiar consulta.
A tabela a seguir descreve as várias opções de como compartilhar 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. Link e consulta para a área de transferência Copie um link que pode ser usado para executar a consulta e o texto da consulta. Link, consulta e resultados para a área de transferência Copie um link que pode 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á-la ou compartilhá-la, por exemplo, no Microsoft Word, no Microsoft Teams ou no 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.
Gerenciar guias do conjunto de consultas
Em 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 salvar consultas para uso posterior ou compartilhamento 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.
Você pode gerenciar suas guias das seguintes maneiras:
- Alterar a conexão da fonte de dados existente: em Explorer e sob a barra de pesquisa, use o comutador de banco de dados para expandir o menu de conexões de fontes de dados.
- Renomear uma guia: ao lado do nome da guia, selecione o ícone de lápis .
- Adicionar uma nova guia: À direita das guias existentes na barra de comandos, selecione o sinal de adição +. Guias diferentes podem ser conectadas a fontes de dados diferentes.
- 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 as posições da guia: 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.
Esse é um método único para exportar um arquivo CSV que contém os resultados da consulta.
Na parte superior da janela de consulta, selecione a guia Início.
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 workspace no qual o conjunto de consultas KQL está localizado.
Passe o mouse sobre o conjunto de consultas KQL que você deseja excluir. Selecione Mais [...]e, em seguida, selecione Excluir.
