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 产品的设计:
“连接”面板
“连接”窗格显示所有已配置的群集连接。 对于每个群集,将显示它们存储的数据库、表和属性(列)。 选择项(在主面板中为搜索/查询设置隐式上下文),或双击项可将名称复制到“搜索/查询”面板。
如果实际架构很大(如具有数百个表的数据库),则可以通过按 CTRL+F 并输入所需实体名称的子字符串(不区分大小写)来进行搜索。
Kusto.Explorer 支持从“查询”窗口控制“连接”面板,这对于脚本非常有用。 例如,你可使用命令启动脚本文件,该命令通过使用以下语法指导 Kusto.Explorer 连接到脚本查询的群集/数据库:
#connect cluster('help').database('Samples')
StormEvents | count
使用 F5
或类似内容运行每行。
“工作文档”面板
“工作文件夹”窗格将工作文件夹整理到一个位置,以方便你浏览工作。 有两种类型的工作文件夹:
- 未保存的工作:列出打开查询选项卡中你可能仍在处理的文件夹。
- 跟踪的文件夹:列出本地设备中的文件夹,你可以将其添加为 KQL 库,以方便访问和管理。
菜单面板
“主文件夹”选项卡
“主页”选项卡显示最常用的操作。 其中包括:
“查询”部分
菜单 | 行为 |
---|---|
模式下拉菜单 |
|
新选项卡 | 打开用于查询 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 的连接。 |
---------数据范围--------- | |
缓存范围 |
|
日期/时间列 | 可用于时间初级筛选器的列的名称。 |
时间筛选器 | 时间初级筛选器的值。 |
“视图”选项卡
菜单 | 行为 |
---|---|
---------外观--------- | |
完整视图模式 | 通过隐藏功能区菜单和连接面板来最大化工作空间。 可通过选择“主页”>“完整视图模式”或按 F11 退出完整视图模式。 |
增大字体 | 增大“查询”选项卡和“结果”数据网格的字体大小。 |
减小字体 | 减小“查询”选项卡和“结果”数据网格的字体大小。 |
重置布局 | 重置工具的停靠控件和窗口的布局。 |
重命名“文档”选项卡 | 重命名所选的选项卡。 |
---------数据视图--------- | |
重置视图 | 将数据视图设置重置为默认值。 |
浏览列值 | 显示列值分布。 |
将焦点置于查询统计信息 | 查询完成时,将焦点更改为查询统计信息,而不是查询结果。 |
隐藏重复项 | 切换从查询结果中删除重复行。 |
隐藏空列 | 从查询结果中移除空列。 |
折叠单数列 | 折叠包含单数值的列。 |
行选择 | 允许在“结果”面板中选择特定的行 |
按列配色 | 按照不同的颜色对第一列中的相同记录进行分组。 |
自动换行 | 设置单元格格式,以根据列宽将数据换行。 |
---------数据筛选--------- | |
筛选搜索中的行 | 切换选项以仅显示查询结果搜索中的匹配行 (Ctrl+F)。 |
---------可视化效果--------- | |
可视化效果 | 请参阅可视化效果。 |
注意
Kusto.Explorer 按每组唯一列跟踪使用的设置。 当对列进行重新排序或删除列时,将保存数据视图,并在检索到具有相同列的数据时重用该视图。 若要将该视图重置为其默认值,请在“视图”选项卡中,选择“重置视图”。
“工具”选项卡
菜单 | 行为 |
---|---|
---------IntelliSense--------- | |
启用 IntelliSense | 启用和禁用脚本面板上的 IntelliSense。 |
问题列表 | 列出“脚本”面板中的问题。 |
---------自动化--------- | |
添加新自动化 | 生成一个分析报表,它提供有关查询的见解。 |
---------实用工具--------- | |
命令行工具 | 在计算机上打开命令提示符。 |
压缩 LZ4 文件 | 使用 LZ4 算法压缩文件。 |
解压缩 LZ4 文件 | 使用 LZ4 算法解压缩文件。 |
---------分析--------- | |
分析报表 | 打开包含多个预建报表的仪表板以进行数据分析。 |
---------转换--------- | |
查询到 Power BI | 将查询转换为适用于在 Power BI 中使用的格式。 |
---------选项--------- | |
重置选项 | 将应用程序设置设置为默认值。 |
选项 | 打开用于配置应用程序设置的工具。 若要了解详细信息,请参阅 Kusto.Explorer 选项。 |
表行颜色
Kusto.Explorer 尝试在结果面板中解释每行的严重性或详细级别,并对它们进行相应的着色。 它通过将每列的非重复值与一组已知模式(“警告”、“错误”等)进行匹配来实现此目的。
若要修改输出配色方案或禁用此行为,请从“工具”菜单中,选择“选项”>“结果查看器”>“详细配色方案”。
Excel 配色方案图例 | 鲜艳配色方案图例 |
---|---|
“监视”选项卡
菜单 | 行为 |
---|---|
---------监视--------- | |
群集诊断 | 显示连接面板中当前选定的服务器组的运行状况摘要。 |
最新数据:所有表 | 显示当前所选数据库的所有表中的最新数据的摘要。 |
最新数据:所选表 | 在状态栏中显示所选表中的最新数据。 |
“管理”选项卡
菜单 | 行为 |
---|---|
---------授权主体--------- | |
管理数据库授权主体 | 支持为授权用户管理数据库的主体。 |
管理表授权主体 | 支持为授权用户管理表的主体。 |
管理函数授权主体 | 支持为授权用户管理函数的主体。 |
“帮助”选项卡
菜单 | 行为 |
---|---|
---------文档--------- | |
帮助 | 打开指向 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
)。
注意
用户的域名不一定与托管群集的租户的域名相同。