将 Superset 连接到 ClickHouse

支持 ClickHouse

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

目标

在本指南中，您将使用 ClickHouse 数据库中的数据在 Superset 中构建一个仪表盘。该仪表盘将如下所示：

准备好连接信息

要通过 HTTP(S) 连接到 ClickHouse，你需要以下信息：

Parameter(s)	Description
`HOST` and `PORT`	通常，使用 TLS 时端口为 8443；不使用 TLS 时端口为 8123。
`DATABASE NAME`	默认情况下，存在一个名为 `default` 的数据库。请使用你要连接的数据库名称。
`USERNAME` and `PASSWORD`	默认情况下，用户名为 `default`。请根据你的使用场景使用相应的用户名。

你的 ClickHouse Cloud 服务的连接信息可在 ClickHouse Cloud 控制台中查看。选择一个服务，然后点击 Connect：

选择 HTTPS。连接信息会显示在示例 curl 命令中。

如果你使用的是自管理 ClickHouse，则连接信息由你的 ClickHouse 管理员配置。

安装驱动程序

Superset 使用 clickhouse-connect 驱动连接到 ClickHouse。有关 clickhouse-connect 的详细信息，请参见 https://pypi.org/project/clickhouse-connect/；可使用以下命令安装：
```
pip install clickhouse-connect
```

将 Superset 连接到 ClickHouse

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

添加数据集

要在 Superset 中与 ClickHouse 数据交互，你需要定义一个 数据集。在 Superset 顶部菜单中，选择 Data，然后从下拉菜单中选择 Datasets。
点击添加数据集的按钮。选择你新建的数据库作为数据源，你应该会看到该数据库中定义的表：

在 Superset 中创建图表和仪表盘

如果你熟悉 Superset，那么接下来这一部分会让你觉得很顺手。如果你是第一次接触 Superset，嗯……它和市面上许多优秀的可视化工具类似——上手很快，但其中的细节和门道需要在使用过程中慢慢积累。

先从仪表盘开始。在 Superset 顶部菜单中，选择 Dashboards。点击右上角的按钮，新建一个仪表盘。下面这个仪表盘名为 UK property prices：

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

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

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