添加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、23.8版本。
操作步骤
登录Quick BI控制台。
按照下图指引添加数据源。
从创建数据源入口进入创建数据源界面。
在自建数据源页签下，选择ClickHouse数据源。
在配置连接对话框，您可以根据业务场景，完成以下配置。
名称
描述
显示名称
数据源配置列表的显示名称。请输入规范的名称，不要使用特殊字符，前后不能包含空格。
数据库地址
部署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语句，语句之间以分号分割。
开启文件上传入口
开启后支持上传文件。
单击连接测试，进行数据源连通性测试。
测试成功后单击确定，完成数据源添加。
后续步骤
创建数据源后，您还可以创建数据集并分析数据。