自建数据源ClickHouse

添加ClickHouse数据源用于连通ClickHouse数据库与Quick BI,连接成功后,您可以在Quick BI上进行数据的分析与展示。Quick BI支持以公网或阿里云VPC的方式连接ClickHouse,本文为您介绍如何添加ClickHouse自建数据源。

前提条件

  • 确保您的网络已连通:

    • 您通过公网连接Quick BIClickHouse数据库,请添加Quick BIIP地址至数据库白名单,请参见添加安全组规则

    • 您通过内网连接Quick BIClickHouse数据库,请通过以下任意一种方式,实现数据源与Quick BI网络连通:

      • ClickHouse数据库搭建在阿里云的ECS上,您可以通过阿里云VPC连接。

      • 您也可以搭建跳板机,并通过SSH隧道访问登录并访问数据库。

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

使用限制

  • 仅支持空间管理员和组织管理员角色的账号新建数据源。

  • Quick BI高级版和专业版支持ClickHouse数据源。

  • 支持20.3、22.8、23.8版本。

操作步骤

  1. 登录Quick BI控制台

  2. 按照下图指引添加数据源。

    1. 创建数据源入口进入创建数据源界面。

    2. 自建数据源页签下,选择ClickHouse数据源。image

  3. 配置连接对话框,您可以根据业务场景,完成以下配置。image

    名称

    描述

    显示名称

    数据源配置列表的显示名称。请输入规范的名称,不要使用特殊字符,前后不能包含空格。

    数据库地址

    部署ClickHouse数据库的地址,包括IP或域名。

    端口

    数据库的对应的端口号,默认为8123。

    数据库

    部署ClickHouse数据库时自定义的数据库名称。

    用户名密码

    登录ClickHouse数据库的用户名和密码。

    时区

    部署ClickHouse数据库所在的时区。

    数据库版本

    选择ClickHouse数据库的版本。

    当数据库版本为23.8及以上时,请选择23.8;当数据库版本为23.8以下时,请选择22.8。

    SSL

    如果目标数据源已配置SSL,您可以选中安全协议SSL,从而保护数据安全。

    VPC数据源

    仅当ClickHouse数据库部署在阿里云ECS上,且网络类型为阿里云VPC网络时,请选中VPC数据源并配置如下参数:

    • 购买者AccessId:购买此实例的AccessKey ID。

      请参见获取AccessKey

      说明

      请确保该AccessKey ID具备目标实例的Read权限。此外,若具有Write权限,系统将自动添加白名单,否则需要您手动添加。相关操作说明请参见创建自定义权限策略

    • 购买者AccessKey:购买此实例的AccessKey Secret。

      请参见获取AccessKey

    • 实例ID:ECS实例ID。请登录ECS管理控制台,在实例页签下获取实例ID。

      请参见查看实例信息

    • 区域:ECS实例所在区域。

      请参见查看实例信息

    SSH

    如果您选中SSH,则需要配置如下参数:

    您可以搭建跳板机,并通过SSH隧道访问登录并访问数据库。跳板机的信息请找运维或系统管理员获取。

    • SSH Host:输入跳板机IP地址。

    • SSH 用户名:登录跳板机的用户名。

    • SSH 密码:登录跳板机的用户名对应密码。

    • SSH 端口:跳板机的端口。默认为22。

    请参见通过密码认证登录Linux实例

    说明

    SSH的地址需要是公网地址,不支持内网地址。

    初始化SQL

    开启后,可配置数据源连接后初始化执行的SQL语句。

    每次数据源连接后初始化执行的SQL语句,只允许SET语句,语句之间以分号分割。

    开启文件上传入口

    开启后支持上传文件。

  4. 单击连接测试,进行数据源连通性测试。

    image

  5. 测试成功后单击确定,完成数据源添加。

后续步骤

创建数据源后,您还可以创建数据集并分析数据。