在 KQL 查询集中查询数据

本文介绍如何使用 KQL 查询集。 KQL 查询集是用于运行查询、查看和自定义来自不同数据源(例如 Eventhouse、KQL 数据库等)的数据的查询结果的项目。

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

先决条件

选择数据库

查询在数据库上下文中运行。 可以随时更改关联的数据库,并保留保存在查询编辑器中的查询。 可以将 KQL 查询集与多个不同类型的数据源关联,包括 KQL 数据库或来自 Azure 数据资源管理器群集的数据库。

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

  1. 打开 KQL 查询集

  2. 在查询页面左侧的连接窗格中,在“Explorer”下,选择“V”以展开数据库连接菜单。

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

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

  4. 在出现的“OneLake 数据中心”窗口中,选择一个 KQL 数据库以连接到 KQL 查询集,然后选择“连接”。 或者,关闭“OneLake 数据中心”窗口并使用“+ 添加数据源”菜单连接到其他数据源。

与此数据库关联的表列表显示在连接窗格中的数据库名称下方。

使用连接窗格与数据库交互

连接窗格可用于浏览和切换连接到查询集的数据库。 在连接窗格中的“数据库”下,选择“V”以展开数据库连接菜单。 选择要浏览的数据库。 连接窗格显示所选数据库中包含的以下项目的细目:

  • 具体化视图
  • 快捷方式
  • 函数

在连接窗格中,可以浏览每个部分中包含的项目。 若要打开操作菜单,请将鼠标悬停在项目上,然后选择“更多菜单”[...]。菜单提供以下选项:

  • 刷新数据
  • 查看数据配置文件
  • 插入,用于创建脚本并将其粘贴到查询编辑器中
  • 删除

不同类型的项目有不同的操作可用。

编写查询

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

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

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

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

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

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

管理查询集选项卡

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

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

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

在命令栏的右侧,有一个菜单,其中包含用于管理查询集中的多个选项卡的其他操作。

用于管理 KQL 查询集中多个选项卡的多个选项卡菜单的屏幕截图。

复制查询

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

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

  2. 在查询窗格中,选择“复制查询”。

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

    下表概述了可用于复制查询的多个选项。

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

  4. 粘贴此信息以编辑或共享,例如在 Microsoft Word、Microsoft Teams 或 Outlook 中。

    重要

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

将查询数据导出为 CSV

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

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

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

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

  2. 在查询窗格中,选择“导出到 CSV”。

  3. 在本地保存 CSV 文件。

删除 KQL 查询集

若要删除 KQL 查询集:

  1. 选择 KQL 查询集所在的工作区。

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

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

下一步