Compartilhar via


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

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

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

  1. Abra seu conjunto de consultas KQL.

  2. No painel de conexão no lado esquerdo da página de consulta, no Explorer, selecione V para expandir o menu de conexões de banco de dados.

    Captura de tela do menu do banco de dados mostrando uma lista de bancos de dados conectados.

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

  4. 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 do OneLake e use o menu +Adicionar fonte de dados para se conectar a uma fonte de dados diferente.

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

Interagir com bancos de dados usando o painel de conexão

O painel de conexão permite que você navegue e alterne entre os bancos de dados conectados ao conjunto de consultas. No painel de conexão, em Banco de Dados, selecione V para expandir o menu de conexões de banco de dados. Selecione o banco de dados que você deseja restaurar. O painel de conexão mostra um detalhamento dos seguintes itens incluídos no banco de dados selecionado:

  • Tabelas
  • Exibição Materializada
  • Atalhos
  • Funções

No painel de conexão, você pode explorar quais itens estão incluídos em cada seção. Para abrir o menu de ação, passe o mouse sobre o item e selecione o menu Mais [...]. O menu fornece opções para:

  • Atualizar dados
  • Exibir perfil de dados
  • Inserir para criar um script e colá-lo no editor de consultas
  • Delete (excluir)

Ações diferentes estão disponíveis para diferentes tipos de itens.

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.

    Captura de tela do Conjunto de Consultas KQL mostrando os resultados de uma consulta. Ambas as consultas e o painel de resultados são destacados.

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.

Captura de tela das opções para guais de edição no Conjunto de Consultas KQL.

  • Adicionar uma nova guia: selecione a adição + à direita das guias existentes. Guias diferentes podem ser conectadas a bancos de dados diferentes.
  • Renomear uma guia: selecione o ícone de lápis ao lado do nome da guia.
  • Alterar posições da guia: alterar as posições da guia usando gestos de arrastar e soltar.
  • Alterar a conexão de banco de dados existente: em Explorer, selecione a conexão de banco de dados existente para abrir o hub de dados.

No lado direito da barra de comandos, há um menu com ações adicionais para gerenciar as várias guias em seu conjunto de consultas.

Captura de tela do menu de várias guias para gerenciar várias guias no conjunto de consultas KQL.

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. No painel de consulta, selecione Copiar consulta.

    Captura de tela da guia Gerenciar do Conjunto de Consultas KQL mostrando o menu suspenso da cópia da consulta ou opção de resultados da 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.
  3. Selecione a ação de compartilhamento desejada na tabela acima.

  4. 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.

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.

    Captura de tela da guia Início do conjunto de consultas KQL mostrando a opção destacada para exportar resultados para CSV.

  2. No painel de consulta, selecione Exportar para CSV.

  3. Salve o arquivo CSV localmente.

Excluir conjunto de consultas KQL

Para excluir seu conjunto de consultas KQL:

  1. Selecione o workspace 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.

    Captura de tela do espaço de trabalho do Microsoft Fabric mostrando como excluir um conjunto de consulta KQL.

Próxima etapa