Quick BI上自建ClickHouse数据源的配置指南

概述

为了实现ClickHouse数据库与Quick BI的无缝对接，本指南将详细介绍如何添加自建ClickHouse数据源。通过这一配置，用户能够在Quick BI平台上对ClickHouse数据库中的数据进行深入分析与可视化展示。Quick BI支持通过公网或阿里云VPC两种方式连接ClickHouse数据库。

前提条件

网络连通性

• 若通过公网连接，请确保已将Quick BI的IP地址 添加至数据库白名单中,请参见 添加安全组规则 。
• 若通过内网连接，则需确保数据源与Quick BI之间的网络连通性。具体可通过阿里云VPC或搭建跳板机并通过SSH隧道访问数据库来实现。

必备信息

• 获取自建ClickHouse数据库的用户名和密码。

使用限制

• 新建数据源的操作仅限于空间管理员和组织管理员角色的账号。
• ClickHouse数据源功能仅适用于Quick BI高级版和专业版。
• 支持的ClickHouse版本为20.3、22.8。

操作步骤

1. 登录Quick BI控制台
   访问Quick BI控制台。

2. 添加数据源

   • 从创建数据源入口进入创建数据源界面。
   • 选择“ClickHouse”作为数据源类型。
   • 选择“自建”作为数据源类型。

3. 配置连接

   • 显示名称：输入规范的名称，避免使用特殊字符。
   • 数据库地址：输入部署ClickHouse数据库的地址（IP或域名）。
   • 端口：输入数据库对应的端口号。
   • 数据库：输入自定义的数据库名称。
   • 用户名和密码：输入登录ClickHouse数据库所需的用户名和密码。
   • 时区：选择部署ClickHouse数据库所在的时区。
   • SSL：如目标数据源已配置SSL，勾选此项以增强数据安全性。
   • VPC数据源：若ClickHouse数据库部署在阿里云ECS上且网络类型为阿里云VPC，则需配置以下参数：
     • 购买者AccessId：获取此实例的AccessKey ID，请参见 获取AccessKey 。
     • 购买者AccessKey：获取此实例的AccessKey Secret，参见获取AccessKey。
     • 实例ID：获取ECS实例ID， 请参见 查看实例信息。
     • 区域：选择ECS实例所在区域，请参见 查看实例信息 。
   • SSH：若选中此选项，则需配置跳板机信息以通过SSH隧道访问数据库，请参见 通过密码认证登录Linux实例。
   • 初始化SQL：开启后可配置数据源连接后的初始化SQL语句。
   • 开启文件上传入口：开启后支持上传文件。

4. 连接测试
   单击“连接测试”按钮进行数据源连通性测试。

5. 完成添加
   测试成功后点击“确定”，完成数据源添加。

后续步骤

• 参考创建并管理数据集，将ClickHouse数据库中的数据表或自定义SQL添加到Quick BI。
• 参考新建仪表板和可视化图表概述，添加可视化图表并分析数据。
• 参考钻取设置与展示，进行数据的钻取和深度分析。