本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 升級 RDS Custom for Oracle 資料庫執行個體
<a name="custom-upgrading-modify"></a>

若要升級 RDS Custom for Oracle 資料庫執行個體，請將其修改為使用新的 CEV。此 CEV 可以包含新的資料庫二進位檔案或新的 AMI。例如，若要將 Oracle Linux 7.9 資料庫執行個體升級至 Oracle Linux 8，請指定使用 Oracle Linux 8 的最新 AMI。若要升級資料庫和作業系統，則必須執行兩個不同的升級。

**注意**  
如果您升級資料庫，RDS Custom 會在升級主要資料庫執行個體之後自動升級僅供讀取複本。如果升級作業系統，您必須手動升級這些複本。

開始之前，請先檢閱 [RDS Custom for Oracle 升級的需求](custom-upgrading.md#custom-upgrading-reqs)和 [RDS Custom for Oracle 資料庫升級的考量](custom-upgrading-considerations.md)。

## 主控台
<a name="custom-upgrading-modify.CON"></a>

**升級 RDS Custom for Oracle 資料庫執行個體**

1. 登入 AWS 管理主控台，開啟位於 [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/) 的 Amazon RDS 主控台。

1. 在導覽窗格中，選擇**資料庫**，然後選擇您要升級的 RDS Custom for Oracle 資料庫執行個體。

1. 選擇 **Modify (修改)**。**Modify DB instance (修改資料庫執行個體)** 頁面隨即出現。

1. 對於**資料庫引擎版本**，選擇新的 CEV。請執行下列操作：
   + 如果您要修補資料庫，請確定 CEV 指定的資料庫二進位檔與資料庫執行個體所使用的資料庫二進位檔案不同，而且未指定與資料庫執行個體目前所用 AMI 不同的 AMI。
   + 如果您要修補作業系統，請確定 CEV 指定的 AMI 與資料庫執行個體所使用的 AMI 不同，而且未指定不同的資料庫二進位檔案。
**警告**  
當您修補作業系統時，您會遺失根磁碟區資料和任何現有的作業系統自訂。

1. 選擇 **Continue (繼續)** 以檢查修改的摘要。

   若要立即套用變更，請選擇 **Apply immediately (立即套用)**。

1. 如果您的變更正確，請選擇 **Modify DB instance (修改資料庫執行個體)**。或者，選擇 **Back (上一步)** 以編輯變更，或是選擇 **Cancel (取消)** 以取消變更。

## AWS CLI
<a name="custom-upgrading-modify.CLI"></a>

下列範例顯示可能的升級案例。這些範例假設您已建立 RDS Custom for Oracle 資料庫執行個體，其具有下列特性：
+ 名為 `my-custom-instance` 的資料庫執行個體
+ 名為 `19.my_cev1` 的 CEV
+ Oracle Database 19c 使用非 CDB 架構
+ 使用 AMI `ami-1234` 的 Oracle Linux 8

最新服務提供的 AMI 為 `ami-2345`。您可以執行 CLI 命令 `describe-db-engine-versions` 來尋找您的 AMI：

**Topics**
+ [升級作業系統](#custom-upgrading-modify.CLI.os)
+ [升級資料庫](#custom-upgrading-modify.CLI.db)

### 升級作業系統
<a name="custom-upgrading-modify.CLI.os"></a>

在此範例中，您想要將 `ami-1234` 升級至 `ami-2345`，這是最新服務提供的 AMI。因為您要升級作業系統，所以 `ami-1234` 和 `ami-2345` 的資料庫二進位檔案必須相同。您建立一個以 `19.my_cev1` 為基礎且名為 `19.my_cev2` 的新 CEV。

**Example**  
在 Linux、macOS 或 Unix 中：  

```
aws rds create-custom-db-engine-version \
    --engine custom-oracle-ee \
    --engine-version 19.my_cev2 \
    --description "Non-CDB CEV based on ami-2345" \
    --kms-key-id key-name \
    --source-custom-db-engine-version-identifer arn:aws:rds:us-west-2:123456789012:cev:custom-oracle-ee/19.my_cev1/12345678-ab12-1234-cde1-abcde123456789 \
    --image-id ami-2345
```
在 Windows 中：  

```
aws rds create-custom-db-engine-version ^
    --engine custom-oracle-ee ^
    --engine-version 19.my_cev2 ^
    --description "Non-CDB CEV based on ami-2345" ^
    --kms-key-id key-name ^
    --source-custom-db-engine-version-identifer arn:aws:rds:us-west-2:123456789012:cev:custom-oracle-ee/19.my_cev1/12345678-ab12-1234-cde1-abcde123456789 ^
    --image-id ami-2345
```

若要升級 RDS Custom 資料庫執行個體，請使用 [modify-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html) AWS CLI 命令搭配下列參數：
+ `--db-instance-identifier` - 指定要升級的 RDS Custom for Oracle 資料庫執行個體。
+ `--engine-version` - 指定具有新 AMI 的 CEV。
+ `--no-apply-immediately` \$1 `--apply-immediately` – 指定要立即執行升級，還是等到排定的維護時段。

下列範例會將 `my-custom-instance` 升級到版本 `19.my_cev2`。僅升級作業系統。

**Example**  
在 Linux、macOS 或 Unix 中：  

```
aws rds modify-db-instance \
    --db-instance-identifier my-custom-instance \
    --engine-version 19.my_cev2 \
    --apply-immediately
```
在 Windows 中：  

```
aws rds modify-db-instance ^
    --db-instance-identifier my-custom-instance ^
    --engine-version 19.my_cev2 ^
    --apply-immediately
```

### 升級資料庫
<a name="custom-upgrading-modify.CLI.db"></a>

在此範例中，您想要將 Oracle 修補程式 p35042068 套用至 RDS for Oracle 資料庫執行個體。因為您已在 [升級作業系統](#custom-upgrading-modify.CLI.os) 中升級作業系統，所以您的資料庫執行個體目前正在使用 `19.my_cev2`，其是以 `ami-2345` 為基礎。您建立名為 `19.my_cev3` 的新 CEV，其也會使用`ami-2345`，但您可以在 `$MANIFEST` 環境變數中指定新的 JSON 清單檔案。因此，資料庫二進位檔案只在新 CEV 和執行個體目前使用的 CEV 中不同。

**Example**  
在 Linux、macOS 或 Unix 中：  

```
aws rds create-custom-db-engine-version \
    --engine custom-oracle-ee \
    --engine-version 19.my_cev3 \
    --description "Non-CDB CEV with p35042068 based on ami-2345" \
    --kms-key-id key-name \
    --image-id ami-2345 \
    --manifest $MANIFEST
```
在 Windows 中：  

```
aws rds create-custom-db-engine-version ^
    --engine custom-oracle-ee ^
    --engine-version 19.my_cev3 ^
    --description "Non-CDB CEV with p35042068 based on ami-2345" ^
    --kms-key-id key-name ^
    --image-id ami-2345 ^
    --manifest $MANIFEST
```

下列範例會將 `my-custom-instance` 升級到引擎版本 `19.my_cev3`。僅升級資料庫。

**Example**  
在 Linux、macOS 或 Unix 中：  

```
aws rds modify-db-instance \
    --db-instance-identifier my-custom-instance \
    --engine-version 19.my_cev3 \
    --apply-immediately
```
在 Windows 中：  

```
aws rds modify-db-instance ^
    --db-instance-identifier my-custom-instance ^
    --engine-version 19.my_cev3 ^
    --apply-immediately
```