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.

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

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 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 as 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 diferentes tipos, incluindo um banco de dados KQL, cluster do Azure Data Explorer ou 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.

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.

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 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-lhe alternar entre as fontes de dados ligadas ao separador do conjunto de consultas em que se encontra.

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 da guia não tiver sido editado anteriormente, ele será automaticamente nomeado com 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
• Visões materializadas
• 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[...]. O menu mostra as seguintes opções:

• Atualizar banco de dados
• Ver perfil de dados
• Explorar dados
• Inserir: para criar e copiar um script
• Obter dados: para adicionar uma nova fonte de dados
• Criar um painel de controlo
• 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 Mais[...]. O menu mostra as seguintes opções:

• 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
• Abrir no banco de dados KQL: abre esta fonte de dados em um banco de dados KQL.

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.

Excluir conjunto de consultas de KQL

Para excluir seu conjunto de consultas KQL:

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

2. Passe o cursor sobre o conjunto de consultas KQL que deseja excluir. Selecione Mais [...] e, em seguida, selecione Eliminar.

   

Próximo passo