文档

自建数据源ClickHouse

更新时间:

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

前提条件

  • 确保您的网络已连通:

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

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

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

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

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

使用限制

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

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

  • 支持20.3、22.8版本。

操作步骤

  1. 登录Quick BI控制台

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

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

    2. 选择ClickHouse数据源。image

    3. 数据源类型选择自建。

      image

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

    名称

    描述

    显示名称

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

    数据库地址

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

    端口

    数据库的对应的端口号。

    数据库

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

    用户名密码

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

    时区

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

    SSL

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

    VPC数据源

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

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

      请参见获取AccessKey

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

      请参见获取AccessKey

    • 实例ID:ECS实例ID。

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

    SSH

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

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

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

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

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

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

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

    初始化SQL

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

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

    开启文件上传入口

    开启后支持上传文件。

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

    image

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

后续步骤

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

  • 本页导读 (0)