在 KQL 查询集中查询数据

本文介绍如何使用 KQL 查询集。 KQL 查询集是用于对 KQL 数据库中的数据运行查询、查看和自定义查询结果的项。

此外,KQL 查询集使用 Kusto 查询语言来创建查询,并且还支持一些 SQL 函数。 若要详细了解查询语言,请参阅 Kusto 查询语言概述

先决条件

选择数据库

查询在数据库上下文中运行。 可以随时更改关联的数据库,并保留保存在查询编辑器中的查询。 可以将 KQL 查询集与 KQL 数据库或 Azure 数据资源管理器群集中的数据库相关联。

选择与所需数据库类型对应的选项卡。

  1. 打开 KQL 查询集

  2. 在“数据库”下,选择“V”以展开数据库连接菜单。

    显示已连接数据库列表的数据库菜单的屏幕截图。

  3. 在“连接源”下,选择“OneLake 数据中心”

  4. 在显示的“OneLake 数据中心”窗口中,选择一个 KQL 数据库,然后选择“选择”

    OneLake 数据中心窗口的屏幕截图,其中显示了选定的 KQL 数据库。

与此数据库关联的表列表显示在数据库名称下方。

编写查询

连接到数据源后,可以对此数据运行查询。 KQL 查询集使用 Kusto 查询语言 (KQL) 从有权访问的任何数据库查询数据。 若要详细了解 KQL,请参阅 Kusto 查询语言概述

以下示例使用在 https://kustosamples.blob.core.windows.net/samplefiles/StormEvents.csv 中公开提供的数据。

  1. 在 KQL 查询集的顶部窗格中写入或复制查询。

  2. 选择“运行”按钮,或按 Shift+Enter 运行查询。

    生成的查询输出将显示在查询窗格下方的结果网格中。 请注意绿色勾形指示查询已成功完成,以及用于计算查询结果的时间。

    显示查询结果的 KQL 查询集的屏幕截图。查询和结果窗格均突出显示。

管理查询集选项卡

可以在 KQL 查询集中创建多个选项卡。 每个选项卡都可以与不同的 KQL 数据库相关联,并允许保存查询供以后使用或与他人共享,以协作进行数据浏览。 还可以更改与任何选项卡关联的 KQL 数据库,以便对处于不同状态的数据运行相同的查询。

KQL 查询集中编辑选项卡的选项屏幕截图。

  • 重命名选项卡:选择选项卡名称旁边的铅笔图标
  • 添加新选项卡:选择现有选项卡右侧的加号 +。 不同的选项卡可以连接到不同的数据库。
  • 更改现有数据库连接:在“数据库”下,选择现有数据库连接以打开数据中心。

复制查询

你可能想要复制或共享创建的查询。

  1. 在查询窗口顶部,选择“首页”选项卡

  2. 选择“复制查询”

    KQL 查询集“管理”选项卡的屏幕截图,显示复制查询或查询结果选项的下拉列表。

    下表概述了用于共享查询的多个选项。

    重要

    接收查询链接的用户必须具有对基础数据的查看权限才能执行查询和查看结果。

    操作 说明
    复制查询 复制查询文本。
    链接到剪贴板 复制可用于运行查询的深层链接。
    将查询和链接复制到剪贴板 复制可用于运行查询的链接和查询文本。
    将链接、查询和结果导出到剪贴板 复制可用于运行查询的链接、查询文本和查询结果。
    复制结果 复制查询结果。
  3. 从上表中选择所需的共享操作。

  4. 将此信息粘贴到任何编辑器中,例如 Microsoft Word。

将查询数据导出为 CSV

除了复制粘贴查询输出外,还可以导出查询结果。

这是导出包含查询结果的 CSV 文件的一次性方法。

  1. 在查询窗口顶部,选择“首页”选项卡

    KQL 查询集“主页”选项卡的屏幕截图,其中突出显示了将结果导出到 CSV 的选项。

  2. 选择“将结果导出到 CSV”。

  3. 在本地保存 CSV 文件。

删除 KQL 查询集

若要删除 KQL 查询集:

  1. 选择 KQL 查询集关联的工作区。

  2. 将鼠标悬停在想要删除的 KQL 查询集上。 选择“更多 [...]”,然后选择“删除”。

    屏幕截图,其中显示了如何删除 KQL 查询集的 Microsoft Fabric 工作区。

下一步