跳到主要内容
跳到主要内容

仪表板

SQL 控制台的仪表板功能允许您收集和共享来自已保存查询的可视化。首先,通过保存和可视化查询,向仪表板添加查询可视化,并使用查询参数使仪表板具有互动性来开始。

核心概念

查询共享

为了与同事共享您的仪表板,请确保共享基础的已保存查询。为了查看可视化,用户至少必须具有对基础已保存查询的只读访问权限。

互动性

使用 查询参数 使您的仪表板具有互动性。例如,您可以在 WHERE 子句中添加查询参数以作为过滤器。

您可以通过选择可视化设置中的“过滤器”类型,在 Global 过滤器侧边栏中切换查询参数输入。您还可以通过将其链接到仪表板上的另一个对象(如表)来切换查询参数输入。请参阅以下快速入门指南的“配置过滤器”部分。

快速入门

让我们创建一个仪表板,以使用 query_log 系统表监控我们的 ClickHouse 服务。

快速入门

创建已保存查询

如果您已经有要可视化的已保存查询,可以跳过此步骤。

打开一个新的查询选项卡。让我们编写一个查询,以统计 ClickHouse 系统表中按天的查询量:

创建已保存查询

我们可以以表格格式查看查询结果,或开始从图表视图构建可视化。在下一步中,我们将查询保存为 queries over time

保存查询

有关已保存查询的更多文档,请参阅 Saving a Query section

我们可以创建并保存另一个查询 query count by query kind,以统计按查询种类分类的查询数量。以下是 SQL 控制台中数据的条形图可视化。

查询结果的条形图可视化

现在有了两个查询,让我们创建一个仪表板来可视化并收集这些查询。

创建仪表板

导航到仪表板面板,点击“新仪表板”。在给定名称后,您将成功创建第一个仪表板!

创建新仪表板

添加可视化

有两个已保存的查询,queries over timequery count by query kind。让我们将第一个可视化为折线图。为您的可视化提供标题和副标题,并选择要可视化的查询。接下来,选择“折线”图表类型,并分配一个 x 轴和一个 y 轴。

添加可视化

在这里,还可以进行其他样式更改——例如数字格式、图例布局和坐标轴标签。

接下来,让我们将第二个查询可视化为表格,并将其放置在折线图下方。

将查询结果可视化为表格

您通过可视化两个已保存的查询创建了第一个仪表板!

配置过滤器

让我们通过在查询种类上添加过滤器使仪表板具有互动性,这样您可以仅显示与插入查询相关的趋势。我们将利用 查询参数 来完成这项工作。

点击折线图旁边的三个点,点击查询旁的铅笔按钮以打开行内查询编辑器。在这里,我们可以直接从仪表板编辑基础的已保存查询。

编辑基础查询

现在,当按下黄色的运行查询按钮时,您将看到之前过滤仅针对插入查询的相同查询。点击保存按钮以更新查询。当您返回到图表设置时,您将能够过滤折线图。

现在,使用顶部功能区中的 Global Filters,您可以通过更改输入来切换过滤器。

调整全局过滤器

假设您想将折线图的过滤器链接到表格。您可以通过返回可视化设置,将 query_kind 查询参数的值源更改为表格,并选择 query_kind 列作为要链接的字段来实现。

更改查询参数

现在,您可以直接从按种类查询的表中控制折线图的过滤器,以使您的仪表板具有互动性。

控制折线图上的过滤器