文档首页/数据治理中心 DataArts Studio/用户指南/管理中心/配置DataArts Studio数据连接参数/OpenSource ClickHouse数据连接参数说明
更新时间：2026-03-17 GMT+08:00
查看PDF
分享

OpenSource ClickHouse数据连接参数说明

服务端若开启了SSL加密，则仅支持勾选数据集成组件。

表1 OpenSource ClickHouse数据连接

参数

是否必选

说明

数据连接类型

是

OpenSource ClickHouse连接固定选择为OpenSource ClickHouse。

数据连接名称

是

数据连接的名称，只能包含字母、数字、下划线和中划线，且长度不超过100个字符。

描述

否

为更好地识别数据连接，此处加以描述信息，长度不能超过100个字符。

标签

否

标识数据连接的属性。设置标签后，便于统一管理。
说明：

标签的名称，只能包含中文、英文字母、数字和下划线，不能以下划线开头，且长度不能超过100个字符。

适用组件

是

选择此连接适用的组件。勾选组件后，才能在相应组件内使用本连接。

说明：
  • 当开启离线数据集成或实时数据集成作业特性后，可勾选数据集成组件，勾选后在数据开发组件创建集成作业时支持选择本数据连接。
  • 离线数据集成或实时数据集成作业功能当前需申请白名单后才能使用。如需使用该特性，请联系客服或技术支持人员。

基础与网络连通配置

IP

是

填写ClickHouseServer所在节点IP。

端口

是

默认使用ClickHouseServer的配置参数http_port，用于接收JDBC请求的端口。

KMS加密密钥

是

通过KMS加解密数据源认证信息，选择KMS中的任一默认密钥或自定义密钥即可。
说明：
  • 第一次通过DataArts Studio或KPS使用KMS加密时，会自动生成默认密钥dlf/default或kps/default。关于默认密钥的更多信息，请参见什么是默认密钥。
  • 仅支持通过对称密钥加密，暂不支持非对称密钥。

绑定Agent

是

选择CDM集群作为网络代理，必须和ClickHouseServer网络互通才可以成功创建连接。如果没有可用的CDM集群，请参考创建CDM集群进行创建。

说明：

CDM集群作为管理中心数据连接Agent时，单集群的并发活动线程最大为200。即当多个数据连接共用同一Agent时，通过这些数据连接提交SQL脚本、Shell脚本、Python脚本等任务的同时运行上限为200，超出的任务将排队等待。建议您按照业务量情况规划多个Agent分担压力。

SSL加密

否

仅勾选数据集成组件后显示。支持对opensource clickhouse服务启用SSL加密传输。默认不开启SSL。如源端SSL未开启，则需手动关闭SSL加密。

数据集成配置

数据库名称

是

配置为要连接的数据库名称。

例如：dbname

驱动版本

否

选择ClickHouse驱动版本。

  • CLICKHOUSE_0_3_1：适用于连接ClickHouse 20.7以下版本，此驱动版本不支持多IP连接数据库服务器。
  • CLICKHOUSE_0_4_2：适用于连接ClickHouse 20.7及以上版本，支持多IP连接数据库服务器。
    说明：
    • 选择CLICKHOUSE_0_4_2驱动版本时，支持的timestamp数据的时间范围最小为1970-01-01 08:00:00。
    • CLICKHOUSE_0_4_2的驱动版本仅支持ClickHouse 20.7及以上的服务器版本。
    • 选择CLICKHOUSE_0_4_2驱动版本时，字段名不能包含()，其他版本不受限制。

引用符号

否

连接引用表名或列名时的分隔符号，参考对应数据库的产品文档进行配置。默认为"。

单次提交行数

否

指定单次批量提交的行数。默认为10000。

连接属性

否

连接属性，包含属性名称和属性值。

例如：

1. socket_timeout: socket连接超时的时间，单位为毫秒。

2. connection_timeout：连接超时，单位为毫秒。

3. dataTransferTimeout：数据传输超时，单位为毫秒。

数据源认证及其他功能配置

用户名

是

ClickHouseServer用户名。

密码

是

ClickHouseServer的访问密码。