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 resultados de consulta em dados de diferentes fontes de dados, como Eventhouse, banco de dados KQL e muito mais.

Você também pode usar um conjunto de consultas KQL para executar consultas entre serviços com dados de um workspace do Log Analytics do Azure Monitor ou de um recurso do Application Insights.

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, um cluster do Azure Data Explorer ou o Azure Monitor.

Selecione a guia que corresponde ao tipo de fonte de dados desejado.

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.

1. Escreva ou copie uma consulta no painel superior do conjunto de consultas KQL.

2. 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ões materializadas
• 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 [...]. O menu mostra as seguintes opções:

• Atualizar banco de dados
• Exibir perfil de dados
• Explorar 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 [...]. 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
• Abra no banco de dados KQL: abre essa fonte de dados em um banco de dados KQL.

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.

Excluir o conjunto de consultas KQL

Para excluir seu conjunto de consultas KQL:

1. Selecione o espaço de trabalho no qual o conjunto de consultas KQL está localizado.

2. Passe o mouse sobre o conjunto de consultas KQL que você deseja excluir. Selecione Mais [...]e, em seguida, selecione Excluir.

   

Próxima etapa