ClickHouse RPM不停机升级/降级

最新推荐文章于 2025-10-01 07:34:41 发布

原创

最新推荐文章于 2025-10-01 07:34:41 发布 · 1.6k 阅读

3 ·

CC 4.0 BY-SA版权

文章标签：

#大数据 #数据库

本文档详细介绍了如何从ClickHouse 20.3.18.10版本平滑升级到21.3.4.25版本，包括数据备份、升级步骤和降级方案。在升级过程中，强调了对配置、元数据和数据的备份策略，以及不停机升级的重要性。同时，提供了升级验证和可能出现的问题处理方法，确保在遇到问题时能够顺利降级回旧版本。

背景

Clickhouse 20.3.18.10 升级到 21.3.4.25版本
目的：该三月份发布的版本支持了更多通用的开窗函数，后续会介绍

升级流程

数据备份

对于没有使用每个shard多副本的集群，并且数据表并非全部都是copy表的情况，我们在做升级的时候就需要考虑自己去做备份了，需要备份的数据有这么几种：

1、配置（建议所有集群情况均备份，因为数据量很小）：升级之前建议备份clickhouse相关的一些配置文件,默认是在/etc/clickhouse目录下的所有文件(不同环境若有不同请自行确认，总之要备份好旧配置)

命令：
sudo cp -r /etc/clickhouse-server /etc/clickhouse-server-bk
sudo cp -r /etc/clickhouse-client /etc/clickhouse-client-bk

2、元数据（建议所有集群情况均备份，因为数据量很小）：默认config.xml配置(具体看真实配置) /var/lib/clickhouse/metadata 下存储了元数据，可以很方便的使用物理copy的方式进行

命令：
cp -rf metadata metadata_bk

3、详细数据（视情况而定，数据量大与小的区别）：默认config.xml配置(具体看真实配置) /var/lib/clickhouse/data 下存储了具体的真正数据，该目录的结构是database下是table, table下是更细粒度的partition, 若该数据并不大且使用物理copy的方式系统磁盘容量可以满足copy后的存储大小，那么建议采用物理copy（注意：在做物理copy前请systemctl stop clickhouse-server 防止数据的写入，因为在copy的过程写入数据可能会导致数据损坏）

4、若数据非常庞大，本地磁盘无法容纳备份后的数据，那么建议采用cl