目标
1. 获取连接信息
你的 ClickHouse Cloud 服务的连接信息可在 ClickHouse Cloud 控制台中查看。
选择一个服务,然后点击 Connect:
选择 HTTPS。连接信息会显示在示例
curl 命令中。
如果你使用的是自管理 ClickHouse,则连接信息由你的 ClickHouse 管理员配置。
2. 安装驱动
-
Superset 使用
clickhouse-connect驱动连接到 ClickHouse。有关clickhouse-connect的详细信息,请参见 https://pypi.org/project/clickhouse-connect/,可使用以下命令安装:
Docker Compose 设置对于基于 Docker 的安装,请参阅 Superset database configuration guide,了解如何将
clickhouse-connect 添加到容器中。- 启动 (或重启) Superset。
3. 将 Superset 连接到 ClickHouse
- 在 Superset 中,从顶部菜单选择 Data,然后从下拉菜单中选择 Databases。点击 + Database 按钮添加新数据库:
- 在第一步中,选择 ClickHouse Connect 作为数据库类型:
- 在第二步中:
- 将 SSL 设置为开启或关闭。
- 输入你之前收集的连接信息。
- 指定 DISPLAY NAME:可以使用你喜欢的任意名称。如果你将连接到多个 ClickHouse 数据库,请使用更具描述性的名称。
- 点击 CONNECT,然后点击 FINISH 按钮完成设置向导。完成后,你应该会在数据库列表中看到你的数据库。
4. 添加数据集
- 要在 Superset 中操作 ClickHouse 数据,您需要先定义一个数据集。在 Superset 顶部菜单中,选择 Data,然后在下拉菜单中选择 Datasets。
- 点击添加数据集按钮。选择新建的数据库作为数据源,然后您应该能看到该数据库中定义的表:
- 点击对话框底部的 ADD 按钮后,您的表就会出现在数据集列表中。现在,您可以开始构建仪表板并分析 ClickHouse 数据了!
5. 在 Superset 中创建图表和仪表盘
- 先从仪表盘开始。在 Superset 顶部菜单中,选择 Dashboards。点击右上角的按钮,新建一个仪表盘。下面这个仪表盘名为 UK property prices:
- 要创建新图表,请在顶部菜单中选择 Charts,然后点击按钮新建图表。你会看到很多选项。下面的示例展示了一个 Pie Chart 图表,它使用 CHOOSE A DATASET 下拉菜单中的 uk_price_paid 数据集:
- Superset 的饼图需要一个 Dimension 和一个 Metric,其余设置都是可选的。你可以自行选择用作维度和指标的字段;本示例使用 ClickHouse 字段
district作为维度,使用AVG(price)作为指标。
- 如果你更喜欢环形图而不是饼图,也可以在 CUSTOMIZE 下设置该选项以及其他选项:
- 点击 SAVE 按钮保存图表,然后在 ADD TO DASHBOARD 下拉菜单中选择 UK property prices,再点击 SAVE & GO TO DASHBOARD,即可保存图表并将其添加到仪表盘:
- 就这些了。基于 ClickHouse 中的数据在 Superset 中构建仪表盘,将为你打开一个高速数据分析的新世界!