文档

一键升级内核大版本

更新时间:

本文介绍如何在云数据库 ClickHouse 社区兼容版控制台一键升级实例内核大版本。

前提条件

  • 云数据库 ClickHouse 社区兼容版内核版本为全部22.8及以上实例和部分21.8实例。

    说明

    查看是否符合升级版本要求,请在集群信息页面的集群属性中查看版本,若版本号右侧有大版本升级,则版本符合升级要求。

  • 实例状态为运行中

注意事项

重要
  • 不同内核大版本间可能存在写入和查询的功能、语法、性能的差异。生产环境,请提前测试验证,已确保排除这些差异对业务的影响。

  • 版本升级过程会多次重启实例,部分实例由于库表数量、分区(Parts)数量过多等因素单次启动过程需要较长时间。您可通过测试验证具体升级时长。

  • 测试验证的具体操作,请参见克隆实例验证版本兼容流程

  • 一键升级内核大版本流程启动后,无法取消。

  • 一键升级内核大版本后无法回退到原版本。

    说明

    一键升级内核大版本后不支持版本回退,如果您需要在版本升级后,仍然具有能回退到原来版本的能力,可尝试通过克隆的方式进行升级,具体操作,请参见通过克隆升级内核大版本

  • 版本升级期间实例会进行多次重启,不可读也不可写,建议在业务低峰期进行操作。

克隆实例验证版本兼容流程

建议您先使用克隆实例进行升级测试,确认新版本实例完全兼容原版本实例的功能以及升级时长后再进行升级。

重要

开启了冷热数据分层的实例,不支持克隆验证。

参考流程:

  1. 进入目标实例集群信息页面,点击左侧导航栏中的备份恢复,实例备份完成后,点击恢复实例

  2. 选择从实时副本克隆,目标内核版本为升级目标版本。

  3. 创建克隆实例。

  4. 进行兼容性验证,常见验证方法:

    1. 拉取原实例上的query_log,在新实例上运行,验证业务查询的新版本兼容性。

    2. 回归业务功能。

操作步骤

  1. 使用阿里云账号登录云数据库ClickHouse控制台

  2. 在页面左上角,选择目标集群所在的地域。

  3. 在左侧导航栏,单击社区版实例列表

  4. 找到目标集群,单击集群ID,进入集群信息页面。

  5. 集群属性区域,单击版本右侧的大版本升级

说明

如果这里显示为当前实例仅支持迁移升级,则可参见通过迁移升级内核大版本进行大版本升级。

  1. 根据页面提示,配置如下参数,点击确定按钮。

配置项

说明

示例

将实例内核版本升级至

目标实例版本,版本升级后无法回退。

当前仅支持的版本有23.8(推荐)和22.8。

23.8(LTS版本)

版本升级执行时间

升级版本的执行时间。

重要

选择指定时间升级和可维护时间段升级后,实例的状态会由运行中变为版本升级中,在指定时间或者运维窗口到来前,实例可正常对外提供读写服务,但是不能执行升降配、扩缩容、迁移等运维操作。

  • 指定时间:选择未来某一指定时间段做大版本升级,默认时间为当前实例的下一次运维窗时间。

  • 可维护时间段升级:默认选取当前集群的运维窗口时间。

  • 立即升级:立即执行升级操作。

2024-05-29 14:46

是否执行克隆验证

勾选已执行克隆验证跳过克隆验证(不推荐)

已执行克隆验证

相关文档

数据迁移同步

通过迁移升级内核大版本

通过克隆升级内核大版本

升级内核小版本