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