跳转到主要内容
Apache Superset 是一个使用 Python 编写的开源数据探索与可视化平台。Superset 通过 ClickHouse 提供的 Python 驱动 连接到 ClickHouse。下面来看看它是如何工作的……

目标

在本指南中,您将使用 ClickHouse 数据库中的数据在 Superset 中构建一个仪表盘。该仪表盘将如下所示:
添加一些数据如果您还没有可用的数据集,可以添加一个示例。本指南使用的是 UK Price Paid 数据集,您也可以选择它。同一文档分类下还有其他几个示例可供参考。

1. 获取连接信息

要通过 HTTP(S) 连接到 ClickHouse,你需要以下信息: 你的 ClickHouse Cloud 服务的连接信息可在 ClickHouse Cloud 控制台中查看。 选择一个服务,然后点击 Connect 选择 HTTPS。连接信息会显示在示例 curl 命令中。 如果你使用的是自管理 ClickHouse,则连接信息由你的 ClickHouse 管理员配置。

2. 安装驱动

  1. Superset 使用 clickhouse-connect 驱动连接到 ClickHouse。有关 clickhouse-connect 的详细信息,请参见 https://pypi.org/project/clickhouse-connect/,可使用以下命令安装:
Docker Compose 设置对于基于 Docker 的安装,请参阅 Superset database configuration guide,了解如何将 clickhouse-connect 添加到容器中。
  1. 启动 (或重启) Superset。

3. 将 Superset 连接到 ClickHouse

  1. 在 Superset 中,从顶部菜单选择 Data,然后从下拉菜单中选择 Databases。点击 + Database 按钮添加新数据库:

  1. 在第一步中,选择 ClickHouse Connect 作为数据库类型:

  1. 在第二步中:
  • 将 SSL 设置为开启或关闭。
  • 输入你之前收集的连接信息。
  • 指定 DISPLAY NAME:可以使用你喜欢的任意名称。如果你将连接到多个 ClickHouse 数据库,请使用更具描述性的名称。

  1. 点击 CONNECT,然后点击 FINISH 按钮完成设置向导。完成后,你应该会在数据库列表中看到你的数据库。

4. 添加数据集

  1. 要在 Superset 中操作 ClickHouse 数据,您需要先定义一个数据集。在 Superset 顶部菜单中,选择 Data,然后在下拉菜单中选择 Datasets
  2. 点击添加数据集按钮。选择新建的数据库作为数据源,然后您应该能看到该数据库中定义的表:

  1. 点击对话框底部的 ADD 按钮后,您的表就会出现在数据集列表中。现在,您可以开始构建仪表板并分析 ClickHouse 数据了!

5. 在 Superset 中创建图表和仪表盘

如果你熟悉 Superset,那么接下来这一部分会让你觉得很顺手。如果你是第一次接触 Superset,嗯……它和市面上许多优秀的可视化工具类似——上手很快,但其中的细节和门道需要在使用过程中慢慢积累。
  1. 先从仪表盘开始。在 Superset 顶部菜单中,选择 Dashboards。点击右上角的按钮,新建一个仪表盘。下面这个仪表盘名为 UK property prices

  1. 要创建新图表,请在顶部菜单中选择 Charts,然后点击按钮新建图表。你会看到很多选项。下面的示例展示了一个 Pie Chart 图表,它使用 CHOOSE A DATASET 下拉菜单中的 uk_price_paid 数据集:

  1. Superset 的饼图需要一个 Dimension 和一个 Metric,其余设置都是可选的。你可以自行选择用作维度和指标的字段;本示例使用 ClickHouse 字段 district 作为维度,使用 AVG(price) 作为指标。

  1. 如果你更喜欢环形图而不是饼图,也可以在 CUSTOMIZE 下设置该选项以及其他选项:

  1. 点击 SAVE 按钮保存图表,然后在 ADD TO DASHBOARD 下拉菜单中选择 UK property prices,再点击 SAVE & GO TO DASHBOARD,即可保存图表并将其添加到仪表盘:

  1. 就这些了。基于 ClickHouse 中的数据在 Superset 中构建仪表盘,将为你打开一个高速数据分析的新世界!

最后修改于 2026年7月2日