# 升级 RDS for Oracle 数据库实例版本
要手动升级 RDS for Oracle 数据库实例的数据库引擎版本，可以使用 AWS 管理控制台、AWS CLI 或 RDS API。有关 RDS 数据库升级的一般信息，请参阅[升级 RDS for Oracle 数据库实例版本](#USER_UpgradeDBInstance.Oracle.Upgrading)。要实现有效的升级目标，请使用 AWS CLI [ describe-db-engine-versions](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-engine-versions.html) 命令。
## 控制台
**使用控制台升级 RDS for Oracle 数据库实例的引擎版本**
1. 登录 AWS 管理控制台 并通过以下网址打开 Amazon RDS 控制台：[https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)。
1. 在导航窗格中，选择 **Databases (数据库)**，然后选择要升级的数据库实例。
1. 选择**修改**。
1. 对于**数据库引擎版本**，请选择更高的数据库版本。
1. 选择**继续**，查看修改摘要。请确保您了解数据库版本升级的含义。无法将升级的数据库实例转换回之前的版本。在继续操作之前，请确保已经使用新版本测试了数据库和应用程序。
1. 决定何时安排升级数据库实例。要立即应用更改，请选择**立即应用**。选择此选项在某些情况下可能导致中断。有关更多信息，请参阅“[使用计划修改设置](USER_ModifyInstance.ApplyImmediately.md)”。
1. 在确认页面上，检查您的更改。如果更改正确无误，请选择 **Modify DB Instance（修改数据库实例）**保存更改。
或者，选择 **Back (返回)** 编辑您的更改，或者选择 **Cancel (取消)** 取消更改。
## AWS CLI
要升级 RDS for Oracle 数据库实例的引擎版本，可以使用 CLI [modify-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html) 命令。指定以下参数：
+ `--db-instance-identifier` – RDS for Oracle 数据库实例的名称。
+ `--engine-version` – 数据库引擎要升级到的版本号。
有关有效的引擎版本的信息，请使用 AWS CLI [describe-db-engine-versions](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-engine-versions.html) 命令。
+ `--allow-major-version-upgrade` – 升级数据库引擎版本。
+ `--no-apply-immediately` – 在下一维护时段内应用更改。要立即应用更改，请使用 `--apply-immediately`。
**Example**
以下示例将名为 `myorainst` 的 CDB 实例从其当前版本 `19.0.0.0.ru-2024-01.rur-2024-01.r1` 升级到版本 `21.0.0.0.ru-2024-04.rur-2024-04.r1`。
对于 Linux、macOS 或 Unix：
```
1. aws rds modify-db-instance \
2. --db-instance-identifier myorainst \
3. --engine-version 21.0.0.0.ru-2024-04.rur-2024-04.r1 \
4. --allow-major-version-upgrade \
5. --no-apply-immediately
```
对于：Windows
```
1. aws rds modify-db-instance ^
2. --db-instance-identifier myorainst ^
3. --engine-version 21.0.0.0.ru-2024-04.rur-2024-04.r1 ^
4. --allow-major-version-upgrade ^
5. --no-apply-immediately
```
## RDS API
要升级 RDS for Oracle DB 数据库实例，可执行 [ModifyDBInstance](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBInstance.html) 操作。指定以下参数：
+ `DBInstanceIdentifier` – 数据库实例的名称，例如 *`myorainst`*。
+ `EngineVersion` – 数据库引擎要升级到的版本号。有关有效的引擎版本的信息，请使用 [DescribeDBEngineVersions](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBEngineVersions.html) 操作。
+ `AllowMajorVersionUpgrade` – 是否允许主版本升级。为此，请将该值设置为 `true`。
+ `ApplyImmediately` – 是立即应用更改还是在下一个维护时段内应用更改。要立即应用更改，请将该值设置为 `true`。要在下一个维护时段内应用更改，请将该值设置为 `false`。