使用智能升级服务完成OceanBase租户版本升级-云数据库OceanBase版-阿里云

随着 OceanBase V4.x 版本的推出，其在性能和 AP 等方面取得了显著提升。许多客户希望将 OceanBase 集群实例从旧版本升级到 V4.x，以充分体验新特性。为了响应这一需求，我们推出了智能升级服务，在确保充分验证兼容性、性能及可行性的同时，兼顾安全回滚机制，为客户提供更便捷、高效的升级体验。

使用限制

当前仅支持从 OceanBase V3.2.x 版本升级到 OceanBase V4.2.x 版本。
当前仅支持租户升级，不支持集群升级。

前提条件

智能升级为白名单功能。如需部署，请联系 OceanBase 客户经理。
源集群实例、源租户以及目标集群实例已准备好。
SQL 审计功能已开启。详见开启 SQL 审计。
集群实例白名单已更新到目标集群实例。详见设置集群白名单分组。

升级流程图

步骤一：环境评估

登录 OceanBase 管理控制台。
在左侧导航栏，选择 自治服务 > 智能升级。
在 智能升级 页面右上角，单击 创建升级任务。

在弹窗中，配置如下参数，然后单击确定。

警告

为了保证升级任务正常进行，请不要在升级期间对源实例和目标实例进行任何运维操作，以免升级失败。

参数	说明
任务名称	输入升级任务名称。
源实例	选择待升级的源集群实例。
源租户	选择待升级的源租户。
评估类型	（可选）勾选实例参数和对象评估。
目标实例	选择目标集群实例。

环境评估完成后，在升级流程区域，单击 确认环境评估结果。
在弹窗的不同页签中，分别单击 确认目标租户参数值、确认目标实例参数值 和 确认对象兼容性报告评估。如需修改，可以在对应页签中单击修改按钮。
重要
有黄色标记的参数表示源端参数值修改过、源端参数值和目标端参数值不一致或目标端特有参数值，建议重点关注。
确认后，单击弹窗左上角的叉号，关闭弹窗。

步骤二：创建租户

说明

此步骤中，系统会自动完成如下操作：

在目标端集群创建一个同名租户
复制源端租户的数据库到目标端
复制源端的用户到目标端
根据源端租户开通的访问地址给目标端租户开通对应地址
迁移部分数据迁移步骤依赖的复杂数据库对象到目标端

在升级流程区域，单击 下一步：创建租户。
在弹窗中，单击确定。
等待租户创建完成。

步骤三：数据迁移

在升级流程区域，单击 下一步：数据迁移，新建数据迁移任务。

在弹窗中，完成如下子步骤：

选择源和目标。配置如下参数，然后单击 下一步。

参数	说明
迁移任务	选择迁移任务。如果系统显示暂无数据，请先购买迁移任务。详见购买数据迁移任务。
迁移任务名称	输入迁移任务名称，不支持空格，最大长度为 64 个字符。

选择迁移类型。直接单击 下一步。
查看迁移对象，然后单击 下一步。
配置迁移选项，然后单击 预检查。关于迁移参数的配置，详见修改参数配置。
在弹窗中，输入 __oceanbase_inner_drc_user 密码并单击 测试连通性。如果测试连接成功，单击保存。
说明
关于 __oceanbase_inner_drc_user 用户的创建及授权，详见创建 OBKV 实例用户及授权。
执行预检查。如果预检查成功，单击 启动任务。

步骤四：性能评估

在升级流程区域，单击 下一步：性能评估，新建性能评估任务。
在弹窗中，完成如下子步骤：
1. 选择源端类型。配置 评估任务名称（可以保留默认值），然后单击 下一步。
2. 流量解析配置。配置 流量采集时间范围。校验通过后，单击 下一步。
  重要
  流量采集时间范围 必须在 SQL 审计功能开启之后。
3. 选择目标端类型。直接单击 下一步。
4. 目标端回放配置，然后单击 下一步。关于目标端回放配置，详见操作步骤。
5. 执行预检查。如果预检查成功，单击启动。

步骤五：流量切换

在升级流程区域，单击 下一步：流量切换。
重要
建议在低峰期进行流量切换。
在弹窗中，完成如下子步骤：
1. 关闭源端会话。单击 关闭源端会话。在弹出的确认框中，单击关闭。
  警告
  关闭源端会话会锁住所有的源端用户，请确认业务应用已经没有流量继续写入。
2. 迁移复杂对象和用户权限。单击 开始迁移。
3. 执行切换前检查。单击 开始检查。检查完成后，需要确认检查完成并且决定是否开启反向增量同步。
  警告
  - 不开启反向增量同步，目标端增量数据将不会同步到源端数据库，同时无法进行反向流量切换。
  - 该步骤会禁用源端的触发器、外键，具体如下：
    MySQL 模式：删除触发器，关闭外键检查
    Oracle 模式：禁用触发器和外键约束
4. 切换应用层链接。
  1. 单击 确认开启租户域名切换。切换后源端租户的访问地址会添加固定前缀，目标端租户访问地址会切换成源端租户访问地址。
  2. 等待切换完成后，再重启应用，使得应用在不更改数据库配置的情况下连接到新的租户。
5. 性能观察。等待半小时，观察流量切换前后半小时内的主要性能数据对比。
  说明
  您可以单击 性能观察 区域右上角 查看目标端更多监控，跳转到 性能监控 页面查看更多监控指标。
6. 单击弹窗左上角的叉号，关闭弹窗。
评估升级效果。
- 如果性能数据符合预期，您可以在升级流程区域，选择 … > 关闭反向增量同步，结束升级流程。
- 如果性能数据不及预期，您可以在升级流程区域，选择 … > 反向切换流量，继续下一步骤。

（可选）步骤六：反向切流

在升级流程区域，选择 … > 反向切换流量。
重要
建议在低峰期进行流量切换。
在弹出的确认框中，输入 switch 并单击切换。
在弹窗中，完成如下子步骤：
1. 关闭目标端会话。单击 关闭目标端会话。在弹出的确认框中，单击关闭。
  警告
  关闭目标端会话会锁定所有目标端用户，并且会杀掉所有现存的数据库连接。
2. 解锁源端用户和对象。单击 解锁源端对象。
  说明
  该步骤会解锁在正向流量切换步骤锁定的用户和被禁用或删除的触发器、外键。
3. 切换应用层链接。先单击 确认开启租户域名切换，然后重启应用。注意：切换后源端租户与目标租户端访问地址会切换为升级前的状态。
4. 单击弹窗左上角的叉号，关闭弹窗。
如果 反向流量切换 节点打勾，说明升级回退已经完成。