Kusto.Explorer 安装和用户界面

适用于:✅Azure 数据资源管理器

Kusto.Explorer 是一款免费软件,可在 Windows 桌面上下载和使用。 借助 Kusto.Explorer,可以在用户友好的界面中使用 Kusto 查询语言 (KQL) 查询和分析数据。 本概述说明如何设置 Kusto.Explorer,并描述将使用的用户界面。

借助 Kusto.Explorer,你可以:

安装 Kusto.Explorer

  • 从以下位置下载并安装 Kusto.Explorer 工具:

  • 或者,在以下位置使用启用了 ClickOnce 的浏览器来访问 Kusto 群集:https://<your_cluster>/?web=0。将 <your_cluster> 替换为你的群集 URI(例如 help.chinaeast2.kusto.chinacloudapi.cn。)

使用 Google Chrome 和 Kusto.Explorer

如果 Google Chrome 是默认浏览器,则需要安装 Chrome 的 ClickOnce 扩展。

如果默认浏览器是 Microsoft Edge,则无需安装此扩展。 在 Microsoft Edge 标志设置中验证 ClickOnce 设置。

用户界面概述

Kusto.Explorer 用户界面的设计使用基于选项卡和面板的布局,这类似于其他 Microsoft 产品的设计:

  • 菜单面板上浏览选项卡以执行各种操作
  • 连接面板中管理连接
  • 在脚本面板中创建要运行的脚本
  • 在结果面板中查看脚本的结果

Kusto Explorer 用户界面的屏幕截图,其中显示了该界面的四个面板的概述。

“连接”面板

“连接”面板的屏幕截图,其中显示了帮助群集的数据库。

“连接”窗格显示所有已配置的群集连接。 对于每个群集,将显示它们存储的数据库、表和属性(列)。 选择项(在主面板中为搜索/查询设置隐式上下文),或双击项可将名称复制到“搜索/查询”面板。

如果实际架构很大(如具有数百个表的数据库),则可以通过按 CTRL+F 并输入所需实体名称的子字符串(不区分大小写)来进行搜索。

Kusto.Explorer 支持从“查询”窗口控制“连接”面板,这对于脚本非常有用。 例如,你可使用命令启动脚本文件,该命令通过使用以下语法指导 Kusto.Explorer 连接到脚本查询的群集/数据库:

#connect cluster('help').database('Samples')

StormEvents | count

使用 F5 或类似内容运行每行。

“工作文档”面板

“工作文件夹”面板的屏幕截图,其中显示了“未保存的工作”和“跟踪的文件夹”。

“工作文件夹”窗格将工作文件夹整理到一个位置,以方便你浏览工作。 有两种类型的工作文件夹:

  • 未保存的工作:列出打开查询选项卡中你可能仍在处理的文件夹。
  • 跟踪的文件夹:列出本地设备中的文件夹,你可以将其添加为 KQL 库,以方便访问和管理。

“主文件夹”选项卡

“主页”选项卡的屏幕截图,其中显示了“主页”选项卡的五个部分。

“主页”选项卡显示最常用的操作。 其中包括:

“查询”部分

标题为“选项卡”的“主页”选项卡部分的屏幕截图,其中显示了用于为查询创建新选项卡的选项。

菜单 行为
模式下拉菜单
  • 查询模式:将查询编辑器切换到查询模式。 可以编写命令并将其保存为查询(默认)
  • 搜索模式:单个查询模式,其中输入的每个命令将立即被处理,并在结果窗格中显示结果
  • Search++ 模式:可在一个或多个表中使用搜索语法搜索字词。 了解有关使用 Search++ 模式的详细信息
新选项卡 打开用于查询 Kusto 查询语言的新选项卡。

“共享”部分

标题为“共享”的“主页”选项卡部分的屏幕截图,其中显示了三个选项。

菜单 行为
将数据导出到剪贴板 将查询和数据集导出到剪贴板。 如果显示图表,则会将图表导出为位图
将结果导出到剪贴板 将数据集导出到剪贴板。 如果显示图表,则会将图表导出为位图
将查询导出到剪贴板 将查询导出到剪贴板

“可视化效果”部分

标题为“可视化效果”的“主页”选项卡部分的屏幕截图,其中显示了用于可视化数据的不同选项。

有关变量可视化效果,请参阅 render 运算符

菜单 行为
面积图 显示一个面积图,其中 X 轴是第一列(必须是数字)。 所有数字列都映射到不同的序列(Y 轴)。
柱形图 显示一个柱形图,其中所有数值列都映射到不同的序列(Y 轴)。 数值前的文本列是 X 轴(可以在 UI 中进行控制)。
条形图 显示一个条形图,其中所有数值列都映射到不同的序列(X 轴)。 数值前的文本列是 Y 轴(可以在 UI 中进行控制)。
堆积面积图 显示一个堆积面积图,其中 X 轴是第一列(必须是数字)。 所有数字列都映射到不同的序列(Y 轴)。
时间图 显示一个时间图,其中 X 轴是第一列(必须是日期/时间)。 所有数字列都映射到不同的序列(Y 轴)。
折线图 显示一个折线图,其中 X 轴是第一列(必须是数字)。 所有数字列都映射到不同的序列(Y 轴)。
异常图 类似于时间图,但使用机器学习异常情况检测算法查找时序数据中的异常情况。 数据必须位于固定间隔桶中。 Kusto.Explorer 使用 series_decompose_anomalies 函数来检测异常情况。
饼图 显示一个饼图,其中色轴是第一列。 θ 轴(必须是一个度量值,转换为百分比)是第二列。
时间阶梯 显示一个梯形图,其中 X 轴是最后两列(必须是日期/时间)。 Y 轴是其他列的组合。
散点图 显示一个散点图,其中 X 轴是第一列(必须是数字)。 所有数字列都映射到不同的序列(Y 轴)。
透视图 显示一个透视表和透视图,选择数据、列、行和各种图表类型时具有全面的灵活性。
时间透视 在事件时间线上进行交互式导航(沿时间轴旋转)

“视图”部分

标题为“视图”的“主页”选项卡部分的屏幕截图,其中显示了用于更改数据视图的选项。

菜单 行为
完整视图模式 通过隐藏功能区菜单和连接面板来最大化工作空间。 可通过选择“主页”>“完整视图模式”或按 F11 退出完整视图模式。
隐藏空列 从数据网格中删除空列。
折叠单数列 折叠包含单数值的列。
浏览列值 显示列值分布
增大字体 增大“查询”选项卡和“结果”数据网格的字体大小。
减小字体 减小“查询”选项卡和“结果”数据网格的字体大小。

注意

数据视图设置:

Kusto.Explorer 按每组唯一列跟踪使用的设置。 当对列进行重新排序或删除列时,将保存数据视图,并在检索到具有相同列的数据时重用该视图。 若要将该视图重置为其默认值,请在“视图”选项卡中,选择“重置视图”。

“文件”选项卡

“文件”选项卡的屏幕截图,其中显示了“文件”选项卡的五个部分。

菜单 行为
---------查询脚本---------
新选项卡 打开新选项卡窗口以查询 Kusto。
打开文件 将数据从 *.kql 文件加载到活动脚本面板。
保存到文件 将活动脚本面板的内容保存到 *.kql 文件。
关闭选项卡 关闭当前选项卡窗口
---------Profiles---------
导入配置文件 导入 Kusto.Explorer 配置文件。
导出配置文件 导出 Kusto.Explorer 配置文件。
---------保存数据---------
将数据导出到 CSV 将数据导出到 CSV(逗号分隔值)文件。
将数据导出到 JSON 将数据导出到 JSON 格式的文件。
将数据导出到 Excel 将数据导出到 XLSX (Excel) 文件。
将数据导出到文本 将数据导出到 TXT(文本)文件。
将数据导出到 KQL 脚本 将查询导出到脚本文件。
将数据导出到结果 将查询和数据导出到结果 (QRES) 文件。
运行查询并保存到 CSV 运行查询并将结果保存到本地 CSV 文件。
---------加载数据---------
从结果 从结果 (QRES) 文件加载查询和数据。
---------剪贴板---------
将查询和结果导出到剪贴板 将查询和数据集导出到剪贴板。 如果显示图表,则会将图表导出为位图。
将结果导出到剪贴板 将数据集导出到剪贴板。 如果显示图表,则会将图表导出为位图。
将查询导出到剪贴板 将查询导出到剪贴板。
将结果导出到剪贴板 (datatable()) 将查询结果导出到剪贴板。 允许的最大单元格值为 30000。
---------结果---------
清除结果缓存 清除以前执行的查询的缓存结果。

“连接”选项卡

“连接”选项卡的屏幕截图,其中显示了“连接”选项卡的五个部分。

菜单 行为
------------------
添加组 添加新的 Kusto 服务器组。
---------群集---------
导入连接 从指定连接的文件中导入连接。
导出连接 将连接导出到文件。
添加连接 添加新的 Kusto 服务器连接。
编辑连接 打开一个对话框以编辑 Kusto 服务器连接属性。
删除连接 删除到 Kusto 服务器的现有连接。
刷新 刷新 Kusto 服务器连接的属性。
---------Profiles---------
导入配置文件 导入 Kusto.Explorer 配置文件。
导出配置文件 导出 Kusto.Explorer 配置文件。
---------安全性---------
检查 ADD 主体 显示当前活动用户详细信息。
注销 注销当前用户与 Microsoft Entra ID 的连接。
---------数据范围---------
缓存范围
  • 仅对热数据缓存执行热 DataExecute 查询
  • 所有数据:对所有可用数据执行查询(默认)。
日期/时间列 可用于时间初级筛选器的列的名称。
时间筛选器 时间初级筛选器的值。

“视图”选项卡

“视图”选项卡的屏幕截图,其中显示了“视图”选项卡的四个部分。

菜单 行为
---------外观---------
完整视图模式 通过隐藏功能区菜单和连接面板来最大化工作空间。 可通过选择“主页”>“完整视图模式”或按 F11 退出完整视图模式。
增大字体 增大“查询”选项卡和“结果”数据网格的字体大小。
减小字体 减小“查询”选项卡和“结果”数据网格的字体大小。
重置布局 重置工具的停靠控件和窗口的布局。
重命名“文档”选项卡 重命名所选的选项卡。
---------数据视图---------
重置视图 数据视图设置重置为默认值。
浏览列值 显示列值分布。
将焦点置于查询统计信息 查询完成时,将焦点更改为查询统计信息,而不是查询结果。
隐藏重复项 切换从查询结果中删除重复行。
隐藏空列 从查询结果中移除空列。
折叠单数列 折叠包含单数值的列。
行选择 允许在“结果”面板中选择特定的行
按列配色 按照不同的颜色对第一列中的相同记录进行分组。
自动换行 设置单元格格式,以根据列宽将数据换行。
---------数据筛选---------
筛选搜索中的行 切换选项以仅显示查询结果搜索中的匹配行 (Ctrl+F)。
---------可视化效果---------
可视化效果 请参阅可视化效果

注意

数据视图设置:

Kusto.Explorer 按每组唯一列跟踪使用的设置。 当对列进行重新排序或删除列时,将保存数据视图,并在检索到具有相同列的数据时重用该视图。 若要将该视图重置为其默认值,请在“视图”选项卡中,选择“重置视图”。

“工具”选项卡

“工具”选项卡的屏幕截图,其中显示了“工具”选项卡的六个部分。

菜单 行为
---------IntelliSense---------
启用 IntelliSense 启用和禁用脚本面板上的 IntelliSense。
问题列表 列出“脚本”面板中的问题。
---------自动化---------
添加新自动化 生成一个分析报表,它提供有关查询的见解。
---------实用工具---------
命令行工具 在计算机上打开命令提示符。
压缩 LZ4 文件 使用 LZ4 算法压缩文件。
解压缩 LZ4 文件 使用 LZ4 算法解压缩文件。
---------分析---------
分析报表 打开包含多个预建报表的仪表板以进行数据分析。
---------转换---------
查询到 Power BI 将查询转换为适用于在 Power BI 中使用的格式。
---------选项---------
重置选项 将应用程序设置设置为默认值。
选项 打开用于配置应用程序设置的工具。 若要了解详细信息,请参阅 Kusto.Explorer 选项

表行颜色

Kusto.Explorer 尝试在结果面板中解释每行的严重性或详细级别,并对它们进行相应的着色。 它通过将每列的非重复值与一组已知模式(“警告”、“错误”等)进行匹配来实现此目的。

若要修改输出配色方案或禁用此行为,请从“工具”菜单中,选择“选项”>“结果查看器”>“详细配色方案”。

Kusto Explorer 配色方案修改的屏幕截图。

Excel 配色方案图例 鲜艳配色方案图例
Kusto Explorer 中 Excel 配色方案图例的屏幕截图。 Kusto Explorer 中鲜艳配色方案图例的屏幕截图。

“监视”选项卡

“监视”选项卡的屏幕截图,其中显示了两个用于监视数据的选项。

菜单 行为
---------监视---------
群集诊断 显示连接面板中当前选定的服务器组的运行状况摘要。
最新数据:所有表 显示当前所选数据库的所有表中的最新数据的摘要。
最新数据:所选表 在状态栏中显示所选表中的最新数据。

“管理”选项卡

“管理”选项卡的屏幕截图,其中显示了用于管理已授权主体的选项。

菜单 行为
---------授权主体---------
管理数据库授权主体 支持为授权用户管理数据库的主体。
管理表授权主体 支持为授权用户管理表的主体。
管理函数授权主体 支持为授权用户管理函数的主体。

“帮助”选项卡

“帮助”选项卡的屏幕截图,其中显示了“文档”的选项。

菜单 行为
---------文档---------
帮助 打开指向 Kusto 联机文档的链接。
新变化 打开列出所有 Kusto.Explorer 更改的文档。
报告问题 打开包含以下两个选项的对话框:
  • 报告与服务相关的问题
  • 报告客户端应用程序中的问题
键盘快捷方式 打开 Kusto.Explorer 键盘快捷方式列表的链接。
显示 EULA 打开 Azure 法律信息文章的链接。

控制连接到 Kusto.Explorer 的用户标识

新连接的默认安全模式是“Microsoft Entra ID 联合安全”。 身份验证是使用默认的 Microsoft Entra 用户体验通过 Microsoft Entra ID 完成的。

如果需要对身份验证参数进行更精细的控制,可以展开“高级:连接字符串”编辑框,并提供有效的 Kusto 连接字符串值。

例如,存在于多个 Microsoft Entra 租户的用户有时需要将其标识的特定“投影”用于特定 Microsoft Entra 租户,这可通过连接字符串(将 IN CAPITALS 一词替换为特定值)来完成此操作:

Data Source=https://CLUSTER_NAME.kusto.chinacloudapi.cn;Initial Catalog=DATABASE_NAME;AAD Federated Security=True;Authority Id=AAD_TENANT_OF_CLUSTER;User=USER_DOMAIN
  • AAD_TENANT_OF_CLUSTER 是托管群集的租户的域名或 Microsoft Entra 租户 ID (GUID)。 例如 contoso.com
  • USER_DOMAIN 是受邀加入该租户的用户的标识(例如 user@example.com)。

注意

用户的域名不一定与托管群集的租户的域名相同。

“添加连接”窗格的屏幕截图,其中显示了标题为“高级连接字符串”的选项。