--- title: "升级概述 - OceanBase 数据库 V4.2.1 | 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.2.1 LTS # 升级概述 更新时间：2026-04-16 00:11:35 [编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.2.1/zh-CN/600.manage/100.cluster-management/300.common-cluster-operations/1500.oceanbase-version-upgrade/200.upgrade-oceanbase-enterprise-edition/100.upgrade-overview.md) OceanBase 集群支持通过使用升级脚本进行集群升级。整个升级过程对应用无感知，应用无需配合服务端做任何的停写停服务操作。OceanBase 集群会按照 Zone 的顺序进行升级。升级过程中，分区 Leader 会在各个 Zone 间进行切主动作，并将要进行升级 Zone 的业务引流到其他 Zone 上执行。 本文档主要讲述 OceanBase 数据库升级限制、升级注意事项和升级路径等信息。 #### 注意 OceanBase 集群暂不支持 V4.0.0 之前的版本原地升级到 V4.x 版本。 ## 升级限制 OceanBase 集群升级时，有如下限制： - 禁止 DDL：升级过程中的部分阶段需要禁止 DDL，升级完成后会自动打开。 - 禁止 `major freeze`：部分版本之间的升级会禁止合并，升级完成后会自动打开。 - 禁止迁移复制和负载均衡：部分版本之间的升级会禁止迁移复制和负载均衡。 - 禁止物理备份恢复：集群升级过程中不会发起物理基线备份（日志归档不断）、物理恢复。 - 禁止新建租户。 #### 注意 如果 OceanBase 集群关联了仲裁服务，那么在进行 OceanBase 集群版本升级时，需要确保先升级仲裁服务版本，然后再升级 OceanBase 集群版本。仲裁服务版本升级的详细信息，请参见 [升级仲裁服务](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000220904)。 可以使用系统租户查询视图 [oceanbase.DBA_OB_ARBITRATION_SERVICE](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000219596) 检查本 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-1000000000220626) - [enable_rebalance](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000220355) - [enable_rereplication](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000220497) ## 升级流程 OceanBase V4.x 升级时执行的升级脚本仅依赖本次目标版本 RPM 包的相关 Python 脚本。即目标版本是 V4.1.0 及以后的版本时，只有一套升级流程，且仅需要目标版本的 OceanBase RPM 包。解压 OceanBase RPM 包可以获取 `oceanbase_upgrade_dep.yml` 文件，该文件记录了 OceanBase 的版本升级拓扑图。 确认升级流程的详细信息，请参见 [升级 OceanBase 集群](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000220905) 中的 **步骤二：确认升级流程** 章节。 ### 升级说明 - 支持 OceanBase 数据库 V4.2.0 版本在线升级到 OceanBase 数据库 V4.2.1 版本。 - 支持 OceanBase 数据库 V4.1.0 版本在线升级到 OceanBase 数据库 V4.2.1 版本。 - 升级期间，系统会自动禁用合并和 DDL 操作，升级完成后恢复正常使用。 - 不支持从 OceanBase 数据库 V3.x 版本在线升级到 OceanBase 数据库 V4.2.1 版本。 - 支持通过 OMS 将 OceanBase 数据库 V3.x 版本数据使用逻辑迁移升级到 OceanBase 数据库 V4.2.1 版本。 ## 后续操作 [升级 OceanBase 集群](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000220905) ## 相关文档 有关使用 OceanBase 云平台（OceanBase Cloud Platform，简称 OCP）升级 OceanBase 集群的操作方法，请参见 [升级版本](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000125677)。 上一篇 下一篇 ![有帮助](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) 咨询热线