升级概述

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.2.2 版本开始，OceanBase 数据库不再支持使用 zlib_1.0 压缩算法。在升级过程中，会进行以下前置检查：

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

• MySQL 模式 PL 权限检查：

  • V4.2.1 升级至 V4.2.5 版本，需要提前确认 _enable_mysql_pl_priv_check 变量；该变量单独控制 MySQL PL 权限检查，且不受 PRIVILEGE_FEATURES_ENABLE 控制，存量租户开启前必须先补齐相关用户的 PL 权限，新建租户默认开启该检查，避免升级后存储过程、函数等 PL 对象因权限缺失导致执行失败。

升级流程

OceanBase V4.x 升级时执行的升级脚本仅依赖本次目标版本 RPM 包的相关 Python 脚本。即目标版本是 V4.1.0 及以后的版本时，只有一套升级流程，且仅需要目标版本的 OceanBase RPM 包。解压 OceanBase RPM 包可以获取 oceanbase_upgrade_dep.yml 文件，该文件记录了 OceanBase 的版本升级拓扑图。

确认升级流程的详细信息，请参见 升级 OceanBase 集群 中的 步骤二：确认升级流程 章节。

升级说明

• 支持 OceanBase 数据库 V4.2.1 BP2 及之前的 V4.x 版本通过有效升级路径在线升级到 OceanBase 数据库 V4.2.2 版本。V4.2.1 BP3 及之后的 BP 版本不再支持升级到 V4.2.2 版本。随着 V4.2.1 和 V4.2.x 版本的并行演进，V4.2.1 的后续 BP 版本也会逐步支持升级到 V4.2.x 后续版本。
• 升级期间，系统会自动禁用合并和 DDL 操作，升级完成后恢复正常使用。

后续操作

升级 OceanBase 集群

相关文档

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