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 um banco de dados KQL.

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 um banco 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 um banco de dados KQL ou a um banco de dados de um cluster do Azure Data Explorer.

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

Banco de dados KQL

1. Abra seu conjunto de consultas KQL.

2. Em Banco de Dados, selecione V para expandir o menu de conexões de banco de dados.

   

3. Em Conectar fonte, selecione Hub de dados OneLake.

4. Na janela do hub de dados OneLake exibida, selecione um banco de dados KQL e selecione Select (Selecionar).

   

Cluster do Azure Data Explorer

1. Abra seu conjunto de consultas KQL.

2. Em Banco de Dados, selecione V para expandir o menu de conexões de banco de dados.

   

3. Na fonte Connect, selecione Azure Data Explorer

4. Em URI de conexão, insira o URI do cluster.

   Para localizar o URI de conexão, vá para o recurso de cluster no portal do Azure. O URI de conexão é o URI encontrado na Visão geral. Para adicionar um cluster de amostra gratuito, especifique "help" como o URI de conexão.

   

5. Em Banco de Dados, selecione o menu suspenso para expandir a lista de bancos de dados no cluster e selecione um banco de dados.

6. Selecione Conectar.

Uma lista de tabelas associadas a esse banco de dados aparece abaixo do nome do banco de dados.

Escreva uma consulta

Agora que você está conectado à fonte de dados, pode executar consultas nesses dados. O conjunto de consultas KQL usa o Linguagem de Consulta Kusto (KQL) para consultar dados de qualquer um dos bancos de dados aos 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.

   

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 estados diferentes.

• Renomear uma guia: selecione o ícone de lápis ao lado do nome da guia.
• Adicionar uma nova guia: selecione a adição + à direita das guias existentes. Guias diferentes podem ser conectadas a bancos de dados diferentes.
• Alterar a conexão de banco de dados existente: em Banco de dados, selecione a conexão de banco de dados existente para abrir o hub de dados.

Copiar consulta

Talvez você queira copiar ou compartilhar as consultas criadas.

1. Na parte superior da janela de consulta, selecione a guia Início.

2. Selecione Copiar consulta.

   

   A tabela a seguir descreve as várias opções de como compartilhar uma consulta.

   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.

   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.

3. Selecione a ação de compartilhamento desejada na tabela acima.

4. Cole essas informações em qualquer editor, como o Microsoft Word.

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.

1. Na parte superior da janela de consulta, selecione a guia Início.

   

2. Selecione Exportar resultados para CSV.

3. Salve o arquivo CSV localmente.

Excluir conjunto de consultas KQL

Para excluir seu conjunto de consultas KQL:

1. Selecione o espaço de trabalho ao qual o conjunto de consultas KQL está associado.

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

   

Próxima etapa

Personalizar resultados na grade de resultados do Conjunto de Consultas KQL