--- title: "升级概述 - OceanBase 数据库 V4.6.0 | OceanBase 文档中心" description: 升级概述 OceanBase 集群支持通过使用升级脚本进行集群升级。整个升级过程对应用无感知，应用无需配合服务端做任何的停写停服务操作。OceanBase 集群会按照 Zone 的顺序进行升级。升级过程中，分区 Leader 会在各个 Zone 间进行切主动作，并将要进行升级 Zone 的业务引流到其他 Zone 上… --- 切换语言 - 中文站 - 简体中文 - International - English - 日本站 - 日本語 文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.6.0 # 升级概述 更新时间：2026-06-30 09:53:14 [编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.6.0/zh-CN/450.oceanbase-version-upgrade/200.upgrade-oceanbase-enterprise-edition/100.upgrade-overview.md) OceanBase 集群支持通过使用升级脚本进行集群升级。整个升级过程对应用无感知，应用无需配合服务端做任何的停写停服务操作。OceanBase 集群会按照 Zone 的顺序进行升级。升级过程中，分区 Leader 会在各个 Zone 间进行切主动作，并将要进行升级 Zone 的业务引流到其他 Zone 上执行。 本文档主要讲述 OceanBase 数据库升级限制、升级注意事项和升级路径等信息。 #### 注意 OceanBase 数据库暂不支持 V4.2.x 系列或更低版本升级到 V4.4.x 版本。 ## 升级限制 OceanBase 集群升级时，有如下限制： - 禁止 DDL：升级过程中的部分阶段需要禁止 DDL，升级完成后会自动打开。 - 禁止 `major freeze`：部分版本之间的升级会禁止合并，升级完成后会自动打开。 - 禁止迁移复制和负载均衡：部分版本之间的升级会禁止迁移复制和负载均衡。 - 禁止物理备份恢复：集群升级过程中不会发起物理基线备份（日志归档不断）、物理恢复。 - 禁止新建租户。 #### 注意 如果 OceanBase 集群关联了仲裁服务，那么在进行 OceanBase 集群版本升级时，需要确保先升级仲裁服务版本，然后再升级 OceanBase 集群版本。仲裁服务版本升级的详细信息，请参见 [升级仲裁服务](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005685804)。 可以使用系统租户查询视图 [oceanbase.DBA_OB_ARBITRATION_SERVICE](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005683979) 检查本 OceanBase 集群是否关联仲裁服务。 ## 注意事项 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](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005685674) - [enable_rebalance](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005685453) - [enable_rereplication](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005685565) - 从 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 及往后的版本集群时，对于备租户，低版本集群无法解析高版本集群生成的日志，此时会在备租户提交日志时报错（仅报错，对应日志不会持久化）。恢复数据的详细信息，参见 [恢复前准备](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005682392)。 - 在 V4.3.2 版本的集群中备份的租户无法在 V4.3.3 版本的集群中恢复。 - 备份恢复 V4.3.2 的版本，无法升级到 V4.3.3（V4.3.2 版本的备份，无法在 V4.3.3 版本恢复）版本。 ## 升级说明 ### 非共享存储模式 - 支持从 V4.4.1 及以下的 V4.4.x 系列版本平滑升级到 V4.6.0 版本。 - 支持从 V4.3.5 BP2 及以下的 V4.3.x 系列版本平滑升级到 V4.6.0 版本，但仅限于 POC 和测试环境，有一定的风险，如果升级遇到问题环境可能需要重建。建议先升级到 V4.4.1 版本后再升级 V4.6.0 版本。 - 支持从 V4.5.0 版本升级到 V4.6.0 版本。 - 暂不支持 V4.2.x 系列或更低版本升级到 V4.6.0 版本。 - 暂不支持 V4.4.2 版本升级到 V4.6.0 版本。 ### 共享存储模式 不支持共享存储模式的低版本升级到 V4.6.0 版本。 ## 升级路径图 ![4257-4356-4421-460](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/observer-enterprise/V4.3.5/1500.oceanbase-version-upgrade/8-4257-4356-4421-460-2.png) #### 说明 - 本文升级路径图仅针对 SN 模式，如需了解更多版本的升级路径，可以参考 `oceanbase_upgrade_dep.yml` 文件，该文件记录了 OceanBase 的版本升级拓扑图。 - 解压目标版本的 OceanBase RPM 包后，会在存放 RPM 包的目录下生成 `home` 和 `use` 两个目录。升级相关脚本和 `oceanbase_upgrade_dep.yml` 文件存放 `home/admin/oceanbase/etc` 目录下。 使用 `oceanbase_upgrade_dep.yml` 文件确认升级路径的详细信息，参见 [升级 OceanBase 集群](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005685806) 中的 **步骤二：确认升级流程** 章节。 **升级路径图含义如下：** - 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 集群](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005685806) ## 相关文档 有关使用 OceanBase 云平台（OceanBase Cloud Platform，简称 OCP）升级 OceanBase 集群的操作方法，请参见 [升级版本](https://www.oceanbase.com/docs/common-ocp-1000000000584725)。 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线