跳到主要内容

ClickHouse 外置（单副本）

适用于外部只有一个 ClickHouse 实例的情况。多个副本请看 ClickHouse 外置（多副本）。

支持初装时指定外置，也支持初装完成后切换外置。初装后切换不迁移旧数据。

1. 准备数据库​

请数据库管理员提供：

  • ONES 可以访问的 ClickHouse 地址、HTTP 端口、TCP 端口、用户名和密码。
  • 有建库、建表、读写权限的账号，且数据库支持 EmbeddedRocksDB、Join 引擎。

使用已包含外置切换功能的 ONES 安装包和业务镜像。当前配置适用于明文 HTTP/TCP，阿里云 ClickHouse 企业版暂不支持。

2. 填写 ONES 配置​

在 ONES 安装操作环境中编辑 config/private.yaml；已安装环境可先执行 ones-ai-k8s.sh 进入。

internalComponentClickhouseEnable: false
clickhouseHost: ch.example.com       # 改成实际地址，不带 http:// 或端口
clickhouseWriteHost: ""              # 保持为空，自动使用上面的地址
clickhousePortHTTP: 8123             # 改成实际 HTTP 端口
clickhousePortTCP: 9000              # 改成实际 TCP 端口
clickhouseUser: ones                 # 改成实际用户名
clickhousePassword: "实际密码"
clickhouseClusterName: ""            # 单副本保持为空
clickhouseLocalFanoutClusterName: ""  # 单副本保持为空

如果配置项已经存在，直接修改原值，不要重复添加。

3. 应用配置​

  • 初装环境：填好配置后，继续正常的 ONES 安装和数据库初始化流程。
  • 已安装环境：执行以下命令：
make setup-ones