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

将 Chartbrew 连接到 ClickHouse

Community Maintained

Chartbrew 是一个数据可视化平台,允许用户创建仪表盘并实时监控数据。它支持多种数据源,包括 ClickHouse,并提供无代码接口用于构建图表和报告。

目标

在本指南中,您将把 Chartbrew 连接到 ClickHouse,运行 SQL 查询,并创建可视化。到最后,您的仪表盘可能会看起来像这样:

Chartbrew dashboard
添加一些数据

如果您没有可用的数据集,可以添加示例之一。本指南使用 UK Price Paid 数据集。

1. 收集连接详情

要通过 HTTP(S) 连接到 ClickHouse,您需要以下信息:

  • 主机端口:通常,当使用 TLS 时端口为 8443,当不使用 TLS 时端口为 8123。

  • 数据库名称:开箱即用时,有一个名为 default 的数据库,请使用您要连接的数据库名称。

  • 用户名密码:开箱即用时,用户名为 default。请使用适合您用例的用户名。

您的 ClickHouse Cloud 服务的详细信息可在 ClickHouse Cloud 控制台中获得。 选择您要连接的服务并点击 连接

ClickHouse Cloud 服务连接按钮

选择 HTTPS,详细信息可在示例的 curl 命令中获得。

ClickHouse Cloud HTTPS 连接详细信息

如果您使用的是自管理的 ClickHouse,连接详细信息由您的 ClickHouse 管理员设置。

2. 将 Chartbrew 连接到 ClickHouse

  1. 登录到 Chartbrew 并转到 Connections 标签。

  2. 点击 Create connection 并从可用数据库选项中选择 ClickHouse

    Select ClickHouse connection in Chartbrew
  3. 输入您的 ClickHouse 数据库的连接详情:

    • Display Name: 用于在 Chartbrew 中识别连接的名称。
    • Host: 您 ClickHouse 服务器的主机名或 IP 地址。
    • Port: 对于 HTTPS 连接,通常为 8443
    • Database Name: 您要连接的数据库。
    • Username: 您的 ClickHouse 用户名。
    • Password: 您的 ClickHouse 密码。
    ClickHouse connection settings in Chartbrew
  4. 点击 Test connection 以验证 Chartbrew 是否能够连接到 ClickHouse。

  5. 如果测试成功,点击 Save connection。Chartbrew 将自动从 ClickHouse 获取模式。

    ClickHouse JSON schema in Chartbrew

3. 创建数据集并运行 SQL 查询

  1. 点击 Create dataset 按钮或转到 Datasets 标签以创建一个。
  2. 选择您之前创建的 ClickHouse 连接。
Select ClickHouse connection for dataset

编写 SQL 查询以检索您想要可视化的数据。例如,这个查询计算了 uk_price_paid 数据集中每年的平均支付价格:

SELECT toYear(date) AS year, avg(price) AS avg_price
FROM uk_price_paid
GROUP BY year
ORDER BY year;
ClickHouse SQL query in Chartbrew

点击 Run query 以获取数据。

如果您不确定如何编写查询,可以使用 Chartbrew's AI assistant 来根据您的数据库模式生成 SQL 查询。

ClickHouse AI SQL assistant in Chartbrew

一旦数据被提取,点击 Configure dataset 来设置可视化参数。

4. 创建可视化

  1. 为您的可视化定义一个度量(数值)和一个维度(类别)。
  2. 预览数据集以确保查询结果结构正确。
  3. 选择一个图表类型(例如线性图、柱状图、饼图),并将其添加到您的仪表盘中。
  4. 点击 Complete dataset 以完成设置。
Chartbrew dashboard with ClickHouse data

您可以创建任意数量的数据集,以可视化数据的不同方面。使用这些数据集,您可以创建多个仪表盘,以跟踪不同的度量。

Chartbrew dashboard with ClickHouse data

5. 自动化数据更新

为了保持仪表盘的最新状态,您可以安排自动数据更新:

  1. 点击数据集刷新按钮旁的日历图标。
  2. 配置更新间隔(例如每小时、每天)。
  3. 保存设置以启用自动刷新。
Chartbrew dataset refresh settings

了解更多

欲了解更多详细信息,请查看有关 Chartbrew 和 ClickHouse 的博客文章。