本文介绍如何使用 KQL 查询集。 KQL 查询集是用于运行查询、查看和自定义来自不同数据源(例如 Eventhouse、KQL 数据库等)的数据的查询结果的项。
还可以使用 KQL 查询集通过 Azure Monitor Log Analytics 工作区 或 Application Insights 资源中的数据执行跨服务查询。
此外,KQL 查询集使用 Kusto 查询语言来创建查询,并且还支持一些 SQL 函数。 若要详细了解查询语言,请参阅 Kusto 查询语言概述。
先决条件
- 具有已启用 Microsoft Fabric 的容量的工作区
- 具有编辑权限和数据的 KQL 数据库,或者具有 AllDatabaseAdmin 权限的 Azure 数据资源管理器群集和数据库。
选择数据源
查询在数据源的上下文中运行。 可以随时更改关联的数据源,并保留保存在查询编辑器中的查询。 可以将 KQL 查询集与不同类型的多个数据源(包括 KQL 数据库、Azure 数据资源管理器群集或 Azure Monitor)相关联。
选择与所需数据源类型对应的选项卡。
在 资源管理器 窗格中的搜索栏中,打开数据库切换器
,然后选择 “添加数据源>Eventhouse/KQL 数据库”。
在 OneLake 目录 窗口中,选择要连接到 KQL 查询集的 KQL 数据库,然后选择“ 连接”。
或者,关闭“OneLake 数据中心”窗口并使用“+ 添加数据源”菜单连接到其他数据源。
与此数据源关联的表列表显示在数据源名称下方。
编写查询
连接到数据源后,可以对此数据运行查询。 KQL 查询集使用 Kusto 查询语言(KQL)从您有权限访问的任意数据源中查询数据。 若要详细了解 KQL,请参阅 Kusto 查询语言概述。
以下示例使用在 https://kustosamples.blob.core.windows.net/samplefiles/StormEvents.csv 中公开提供的数据。
在 KQL 查询集的上方窗格中输入或复制查询。
选择“运行”按钮,或按 Shift+Enter 运行查询。
生成的查询输出将显示在查询窗格下方的结果网格中。 请注意绿色勾号(它指示查询已成功完成)以及用于计算查询结果的时间。
与数据源交互
凭借数据源资源管理器,可以在所处查询集选项卡连接的数据源之间进行切换。
在“数据源资源管理器”窗格顶部的“Explorer”下,可以使用搜索栏搜索特定数据源。 还可以使用搜索栏下方的数据库切换器以展开数据源连接菜单。 选择要使用的数据源。 如果之前未编辑过选项卡名称,它会自动以数据源命名。
数据源资源管理器窗格有两个部分。 上半部分列出了数据源中的所有项,下半部分显示了查询集中所有可用的数据源。
数据源中的项目
数据源资源管理器的上半部分显示了你正在使用的数据源中包含的所有项。
- 表格
- 具体化视图
- 快捷方式
- 函数
选择您要展开的项目左侧的箭头 >。 通过选择后续列表级别中项左侧的箭头 >,可以向下钻取以显示更多详细信息。 例如,在“表”下,选择表左侧的箭头 以显示该表中列的列表>。
若要打开作菜单,请将鼠标悬停在展开列表中的某个项上,然后选择 “更多”菜单 [...]。菜单显示以下选项:
- 刷新数据库
- 查看数据概况
- 浏览数据
- 插入,以创建并复制脚本
- 获取数据:添加新数据源
- 创建仪表板
- 删除表
不同的操作可用于不同的项类型。
可用数据源
数据源资源管理器的下半部分显示添加到查询集中的所有可用数据源。
若要打开作菜单,请将鼠标悬停在数据源名称上,然后选择 “更多”菜单 [...]。菜单显示以下选项:
- 刷新数据库
- 使用此数据库:切换以在当前选项卡中使用此数据源
- 在新选项卡中查询:在查询集中的新选项卡中打开此数据源
- 删除源:删除该数据源中的所有数据库
- 删除数据库:仅删除所选数据库
- 在 KQL 数据库中打开:在 KQL 数据库中打开此数据源。
管理查询集选项卡
可以在 KQL 查询集中创建多个选项卡。 每个选项卡都可以与不同的 KQL 数据库相关联,并允许保存查询供以后使用或与他人共享,以协作进行数据浏览。 还可以更改与任何选项卡关联的 KQL 数据库,使你可以对不同数据库中的数据运行相同的查询。
可通过以下方式管理选项卡:
- 更改现有数据源连接:在“资源管理器”和搜索栏下,使用数据库切换器展开数据源连接菜单。
- 对选项卡重命名:在选项卡名称旁边,选择“铅笔图标”。
- 添加新选项卡:在命令栏中现有选项卡的右侧,选择加号 +。 不同的选项卡可以连接到不同的数据源。
- 更多操作:在命令栏右侧,有一个选项卡菜单,其中包含更多用于管理查询集中的多个选项卡的操作。
- 更改选项卡位置:使用拖放手势。
删除 KQL 查询集
要删除您的 KQL 查询集,请执行以下步骤: