升级概述

OceanBase 集群支持通过使用升级脚本进行集群升级。整个升级过程对应用无感知，应用无需配合服务端做任何的停写停服务操作。OceanBase 集群会按照 Zone 的顺序进行升级。升级过程中，分区 Leader 会在各个 Zone 间进行切主动作，并将要进行升级 Zone 的业务引流到其他 Zone 上执行。

本文档主要讲述 OceanBase 数据库升级限制、升级注意事项和升级路径等信息。

升级限制

OceanBase 集群升级时，有如下限制：

• 禁止 DDL：升级过程中的部分阶段需要禁止 DDL，升级完成后会自动打开。
• 禁止 major freeze：部分版本之间的升级会禁止合并，升级完成后会自动打开。
• 禁止迁移复制和负载均衡：部分版本之间的升级会禁止迁移复制和负载均衡。
• 禁止物理备份恢复：集群升级过程中不会发起物理基线备份（日志归档不断）、物理恢复。
• 禁止新建租户。

注意事项

OceanBase 集群升级时，需要注意以下几点：

• OceanBase V4.0 版本升级至 V4.1 版本的过程中会停日志归档。

• 升级过程如果需要 ADD SERVER/DELETE SERVER 操作，请联系技术人员支持。

• OceanBase 过渡版本不可以直接升级，需要参考 oceanbase_upgrade_dep.yml 文件中的升级版本序列。

• 升级脚本需要直连 Root Service 服务所在的 observer 进程执行，不能通过 OceanBase 数据库代理（OceanBase Database Proxy，简称：ODP） 连接。

• 升级过程中可能会涉及下列参数的变化，升级前需要对这些参数进行备份：

  • server_permanent_offline_time
  • enable_rebalance
  • enable_rereplication

• 从 V4.3.0 Beta 版本开始，OceanBase 数据库不再支持使用 zlib_1.0 压缩算法。在升级过程中，会进行以下前置检查：

  • 在升级过程中，不再支持使用 zlib 压缩算法作为 log_transport_compress_func 参数。请使用其他压缩算法替代 zlib 压缩算法。
  • 在升级过程中，如果发现某些表使用了 zlib 压缩算法，请将这些表中的压缩算法替换为其他支持的压缩算法，或者在升级期间不使用压缩。
  • 在升级过程中，不允许使用 zlib 作为 OBKV-Table 连接的压缩算法。请通过设置 tableapi_transport_compress_func 参数来选择其他的压缩算法。

• 在 ARM 架构和不支持 AVX2（Advanced Vector Extensions 2） 指令集的 x86 机型集群内，如果存在使用过列存表时（存在使用列存表或列存表修改为行存表的场景），不能从 V4.3 的低版本（V4.3.0、V4.3.1 和 V4.3.2）升级到 V4.3.3 及往后的版本，以防止升级后出现数据正确性风险。

• 当有 V4.3 的低版本集群升级到 V4.3.3 及往后的版本集群时，对于备租户，低版本集群无法解析高版本集群生成的日志，此时会在备租户提交日志时报错（仅报错，对应日志不会持久化）。恢复数据的详细信息，参见 恢复前准备。

• 在 V4.3.2 版本的集群中备份的租户无法在 V4.3.3 版本的集群中恢复。

• 在 V4.2.5 BP3、V4.2.5 BP4、V4.2.5 BP5、V4.3.5 BP1、V4.3.5 BP2、V4.3.5 BP3 版本增加了对 X86 架构环境运行的指令集要求。OBServer 进程会在启动前检查当前环境是否支持 AVX 指令集，如果缺少该指令集会禁止启动。将不支持 AVX 指令集的 X86 机器上的旧版 OBServer 升级至上述版本会造成无法启动和回退的情况，请务必关注。

  说明

  OceanBase 数据库自以下版本开始对 AVX 指令集的强制依赖策略已调整：

  • 对于 V4.3.5 版本，从 V4.3.5 BP4 版本开始不再强制要求 AVX 指令集支持。
  • 对于 V4.2.5 版本，从 V4.2.5 BP6 版本开始不再强制要求 AVX 指令集支持。
  • 对于 V4.4.0 版本，从 V4.4.1 版本开始不再强制要求 AVX 指令集支持。

升级说明

• 支持从 V4.3.x 各版本升级到 V4.3.5 BP6 版本。
• 不支持 V4.2.x 系列或更低版本升级到 V4.3.5 BP6 版本。
• 自 V4.3.2 重构了多源数据的持久化格式，升级过程中需要对新旧多源数据格式进行转换，在分区数较多时预留相对充足的升级时间。
• 对于有持续写入的向量场景，需要进行索引重建。
• V4.3.0/V4.3.1/V4.3.2 升级到 V4.3.5 BP5 版本混部过程中，租户 Leader 在老节点时会导致 transfer 失败，需要升级至 V4.3.5 BP5 版本才能正常执行 transfer。

升级路径图

升级路径图含义如下：

• V4.2.x 版本的路径：

  • V4.0.0.0/V4.1.0.0-V4.1.0.2/V4.2.0.0 版本可以升级到 V4.2.1.11 版本，然后再升级至 V4.2.5.7 版本。
  • V4.2.2-V4.2.4 可以直接升级到 V4.2.5.7 版本，也可以先升级到 V4.2.5.0-V4.2.5.6 版本，然后再升级至 V4.2.5.7 版本。
  • V4.2.5 BP7 版本可以直接升级到 V4.4.2 或 V4.4.2.1 版本。
  • barrier 版本：V4.2.1.11、V4.2.5.7。

• V4.3.x 版本的升级路径：

  • V4.3.x 各版本都可以直接升级到 V4.3.5.6 版本。
  • V4.3.5.6 版本可以升级到 V4.4.2.1 版本。
  • 暂不支持 V4.2.x 系列或更低版本升级到 V4.3.x 版本。
  • barrier 版本：V4.3.5.6。

• V4.4.x 版本的升级路径：

  • V4.4.0/V4.4.1 版本可以直接升级到 V4.4.2 版本或 V4.4.2.1 版本。
  • V4.4.0/V4.4.1 版本可以直接升级到 V4.6.0 版本。

• V4.5.x 版本的升级路径：

  • V4.5.0 版本可以升级到 V4.6.0 版本。

后续操作

升级 OceanBase 集群

相关文档

有关使用 OceanBase 云平台（OceanBase Cloud Platform，简称 OCP）升级 OceanBase 集群的操作方法，请参见 升级版本。