仪表盘
SQL 控制台的仪表盘功能允许您从已保存的查询中收集和共享可视化。通过保存和可视化查询、将查询可视化添加到仪表盘以及使用查询参数使仪表盘具有交互性来开始使用。
核心概念
查询共享
为了与同事共享您的仪表盘,请确保共享底层的已保存查询。要查看可视化,用户必须至少具有对底层已保存查询的只读访问权限。
交互性
使用查询参数使您的仪表盘具有交互性。例如,您可以向 WHERE
子句添加查询参数以用作过滤器。
您可以通过在可视化设置中选择“过滤器”类型,经由**全局**过滤器侧面板切换查询参数输入。您还可以通过链接到仪表盘上的另一个对象(如表格)来切换查询参数输入。请参阅下面快速入门指南的“配置过滤器”部分。
快速入门
让我们创建一个仪表盘,使用 query_log 系统表来监控我们的 ClickHouse 服务。
快速入门
创建已保存的查询
如果您已经有要可视化的已保存查询,则可以跳过此步骤。
打开一个新的查询标签页。让我们编写一个查询,以使用 ClickHouse 系统表来计算服务上每天的查询量
我们可以以表格格式查看查询结果,或者从图表视图开始构建可视化。对于下一步,我们将继续并将查询另存为 `queries over time`
有关已保存查询的更多文档,请参见“保存查询”部分。
我们可以创建并保存另一个查询 `query count by query kind`,以按查询类型计算查询数量。这是 SQL 控制台中数据的条形图可视化。
现在有两个查询了,让我们创建一个仪表盘来可视化和收集这些查询。
创建仪表盘
导航到“仪表盘”面板,然后点击“新建仪表盘”。在您分配名称后,您就成功创建了您的第一个仪表盘!
添加可视化
有两个已保存的查询:`queries over time` 和 `query count by query kind`。让我们将第一个可视化为折线图。为您的可视化指定标题和副标题,并选择要可视化的查询。接下来,选择“折线”图表类型,并分配 x 轴和 y 轴。
在这里,还可以进行额外的样式更改 - 例如数字格式、图例布局和轴标签。
接下来,让我们将第二个查询可视化为表格,并将其放置在折线图下方。
您已通过可视化两个已保存的查询创建了您的第一个仪表盘!
配置过滤器
让我们通过在查询类型上添加过滤器来使此仪表盘具有交互性,以便您可以仅显示与 Insert 查询相关的趋势。我们将使用查询参数来完成此任务。
点击折线图旁边的三个点,然后点击查询旁边的铅笔按钮以打开内联查询编辑器。在这里,我们可以直接从仪表盘编辑底层的已保存查询。
现在,当按下黄色运行查询按钮时,您将看到与之前相同的查询,但已过滤为仅包含 insert 查询。点击保存按钮以更新查询。当您返回图表设置时,您将能够过滤折线图。
现在,使用顶部功能区上的“全局过滤器”,您可以通过更改输入来切换过滤器。
假设您想将折线图的过滤器链接到表格。您可以通过返回可视化设置,并将 `query_kind` 查询参数的值来源更改为表格,然后选择 `query_kind` 列作为要链接的字段来完成此操作。
现在,您可以直接从按类型查询的表格控制折线图上的过滤器,以使您的仪表盘具有交互性。