tutorial do Real-Time Intelligence parte 5: Consultar dados de streaming usando KQL

Nesta parte do tutorial, você consulta dados de streaming usando alguns métodos diferentes. Você escreve uma consulta KQL para visualizar dados em um gráfico de tempo e cria uma consulta de agregação usando uma exibição materializada. Você também consulta dados usando t-SQL e usando explain para converter SQL em KQL. Por fim, use Copilot para gerar uma consulta KQL.

Escrever uma consulta KQL

O nome da tabela que você criou com base na política de atualização em uma etapa anterior é TransformedData. Use esse nome de tabela (sensível a maiúsculas e minúsculas) como a fonte de dados para sua consulta.

• No Tutorial_queryset, insira a consulta a seguir e pressione Shift + Enter para executar a consulta.

  TransformedData
  | where BikepointID > 100 and Neighbourhood == "Chelsea"
  | project Timestamp, No_Bikes
  | render timechart
  

  Essa consulta cria um gráfico temporal que mostra o número de bicicletas no bairro Chelsea.

  

Criar uma visão materializada

Nesta etapa, você criará uma visão materializada, que retorna um resultado atualizado da consulta de agregação. Consultar uma exibição materializada é mais rápido do que executar a agregação diretamente sobre a tabela de origem.

1. Copie e cole e execute o comando a seguir para criar uma exibição materializada que mostre o número mais recente de bicicletas em cada estação de bicicleta.

   .create-or-alter materialized-view with (folder="Gold") AggregatedData on table TransformedData
   {
      TransformedData
      | summarize arg_max(Timestamp,No_Bikes) by BikepointID
   }
   

2. Copie e cole e execute a consulta a seguir para ver os dados na exibição materializada como um gráfico de colunas.

   AggregatedData
   | sort by BikepointID
   | render columnchart with (ycolumns=No_Bikes,xcolumn=BikepointID)
   

   

Use essa consulta em uma etapa posterior para criar um painel em tempo real.

Consulta usando T-SQL

O editor de consultas dá suporte ao uso do T-SQL.

• Insira a consulta a seguir e pressione Shift + Enter para executar a consulta.

  SELECT top(10) *
  FROM AggregatedData
  ORDER BY No_Bikes DESC
  

  Essa consulta retorna as 10 principais estações de bicicleta com mais bicicletas, classificadas em ordem decrescente.

  BikepointID	Timestamp	Sem_Bicicletas
  193	2025-12-29 13:40:58.760	39
  602	2025-12-29 13:40:53.009	34
  229	2025-12-29 13:40:56.510	32
  738	2025-12-29 13:40:56.510	32
  313	2025-12-29 13:40:53.009	30
  706	2025-12-29 13:40:58.760	27
  460	2025-12-29 13:40:53.009	27
  522	2025-12-29 13:40:53.009	26
  357	2025-12-29 13:40:53.009	vinte e cinco
  166	2025-12-29 13:40:58.760	24

Converter uma consulta SQL em KQL

Para obter o KQL equivalente para uma instrução T-SQL SELECT, adicione a palavra-chave explain antes da consulta. A saída mostra a versão KQL da consulta, que você pode copiar e executar no editor de consultas KQL.

• Insira a consulta a seguir. Em seguida, pressione Shift + Enter para executar a consulta.

  explain
  SELECT top(10) *
  FROM AggregatedData
  ORDER BY No_Bikes DESC
  

  Essa consulta retorna um equivalente KQL da consulta T-SQL inserida. A consulta KQL é exibida no painel de saída. Tente copiar e colar a saída e execute a consulta. Essa consulta pode não ser gravada em KQL otimizado.

  

Usar Copilot para gerar uma consulta KQL

Se você não estiver familiarizado com a escrita KQL, poderá fazer uma pergunta em linguagem natural e o Copilot gerará a consulta KQL para você.

1. Selecione Queryset na barra de menus.

2. No conjunto de consultas KQL, selecione o ícone Copilot na barra de menus.

   

3. Insira uma pergunta em linguagem natural. Por exemplo, "Qual estação tem mais bicicletas no momento. Use a visão materializada para os dados mais atualizados." Isso pode ajudar a incluir o nome da visão materializada em sua pergunta.

   O Copilot sugere uma consulta com base na sua pergunta.

4. Selecione o botão Inserir para adicionar a consulta ao editor KQL.

   

5. Clique em Executar para executar a consulta.

Faça perguntas de acompanhamento ou altere o escopo da consulta. Use esse recurso para aprender KQL e gerar consultas rapidamente.

Conteúdo relacionado

Para obter mais informações sobre tarefas neste tutorial, consulte:

• Gravar uma consulta
• operador de renderização
• Visão geral de visões materializadas
• Criar exibições materializadas
• Consultar dados usando T-SQL
• Copilot para escrever consultas KQL

Próxima etapa