在 KQL 查询集中查询数据
本文介绍如何使用 KQL 查询集。 KQL 查询集是用于运行查询、查看和自定义来自不同数据源(例如 Eventhouse、KQL 数据库等)的数据的查询结果的项目。
此外,KQL 查询集使用 Kusto 查询语言来创建查询,并且还支持一些 SQL 函数。 若要详细了解查询语言,请参阅 Kusto 查询语言概述。
先决条件
- 具有已启用 Microsoft Fabric 的容量的工作区
- 具有编辑权限和数据的 KQL 数据库,或者具有 AllDatabaseAdmin 权限的 Azure 数据资源管理器群集和数据库。
选择数据库
查询在数据库上下文中运行。 可以随时更改关联的数据库,并保留保存在查询编辑器中的查询。 可以将 KQL 查询集与多个不同类型的数据源关联,包括 KQL 数据库或来自 Azure 数据资源管理器群集的数据库。
选择与所需数据库类型对应的选项卡。
在查询页面左侧的连接窗格中,在“Explorer”下,选择“V”以展开数据库连接菜单。
在“连接源”下,选择“OneLake 数据中心”。
在出现的“OneLake 数据中心”窗口中,选择一个 KQL 数据库以连接到 KQL 查询集,然后选择“连接”。 或者,关闭“OneLake 数据中心”窗口并使用“+ 添加数据源”菜单连接到其他数据源。
与此数据库关联的表列表显示在连接窗格中的数据库名称下方。
使用连接窗格与数据库交互
连接窗格可用于浏览和切换连接到查询集的数据库。 在连接窗格中的“数据库”下,选择“V”以展开数据库连接菜单。 选择要浏览的数据库。 连接窗格显示所选数据库中包含的以下项目的细目:
- 表
- 具体化视图
- 快捷方式
- 函数
在连接窗格中,可以浏览每个部分中包含的项目。 若要打开操作菜单,请将鼠标悬停在项目上,然后选择“更多菜单”[...]。菜单提供以下选项:
- 刷新数据
- 查看数据配置文件
- 插入,用于创建脚本并将其粘贴到查询编辑器中
- 删除
不同类型的项目有不同的操作可用。
编写查询
连接到数据源后,可以对此数据运行查询。 KQL 查询集使用 Kusto 查询语言 (KQL) 从有权访问的任何数据库查询数据。 若要详细了解 KQL,请参阅 Kusto 查询语言概述。
以下示例使用在 https://kustosamples.blob.core.windows.net/samplefiles/StormEvents.csv 中公开提供的数据。
在 KQL 查询集的顶部窗格中写入或复制查询。
选择“运行”按钮,或按 Shift+Enter 运行查询。
生成的查询输出将显示在查询窗格下方的结果网格中。 请注意绿色勾号(它指示查询已成功完成)以及用于计算查询结果的时间。
管理查询集选项卡
可以在 KQL 查询集中创建多个选项卡。 每个选项卡都可以与不同的 KQL 数据库相关联,并允许保存查询供以后使用或与他人共享,以协作进行数据浏览。 还可以更改与任何选项卡关联的 KQL 数据库,以便对处于不同状态的数据运行相同的查询。
- 添加新选项卡:选择现有选项卡右侧的加号 +。 不同的选项卡可以连接到不同的数据库。
- 重命名选项卡:选择选项卡名称旁边的铅笔图标 。
- 更改选项卡位置:使用拖放手势更改选项卡位置。
- 更改现有数据库连接:在“Explorer”下,选择现有数据库连接以打开数据中心。
在命令栏的右侧,有一个菜单,其中包含用于管理查询集中的多个选项卡的其他操作。
复制查询
你可能想要复制和共享创建的查询。
在查询窗口顶部,选择“首页”选项卡。
在查询窗格中,选择“复制查询”。
下表概述了可用于复制查询的多个选项。
操作 说明 复制查询 复制查询文本。 链接到剪贴板 复制可用于运行查询的深层链接。 将查询和链接复制到剪贴板 复制可用于运行查询的链接和查询文本。 将链接、查询和结果导出到剪贴板 复制可用于运行查询的链接、查询文本和查询结果。 复制结果 复制查询结果。 从上表中选择所需的操作。
粘贴此信息以编辑或共享,例如在 Microsoft Word、Microsoft Teams 或 Outlook 中。
重要
接收查询链接的用户必须具有对基础数据的查看权限才能执行查询和查看结果。
将查询数据导出为 CSV
除了复制粘贴查询输出外,还可以导出查询结果。
这是导出包含查询结果的 CSV 文件的一次性方法。
在查询窗口顶部,选择“首页”选项卡。
在查询窗格中,选择“导出到 CSV”。
在本地保存 CSV 文件。
删除 KQL 查询集
若要删除 KQL 查询集: