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

# 升級 MariaDB 資料庫快照引擎版本
<a name="mariadb-upgrade-snapshot"></a>

利用 Amazon RDS，您可以為您的 MariaDB 資料庫執行個體建立儲存體磁碟區資料庫快照。建立資料庫快照時，該快照會基於您的資料庫執行個體使用的引擎版本。您可以升級資料庫快照的引擎版本。

針對 RDS for MariaDB，您可以升級至所有可用的引擎版本。您可以升級加密或未加密的資料庫快照。

若要檢視 RDS for MariaDB 資料庫快照的可用引擎版本，請使用下列 AWS CLI 範例。

```
aws rds describe-db-engine-versions --engine mariadb --include-all --engine-version example-engine-version --query "DBEngineVersions[*].ValidUpgradeTarget[*].{EngineVersion:EngineVersion}" --output text
```

如果您沒有看到快照的結果，則您的引擎版本可能已棄用。如果您的引擎版本已棄用，建議您升級到最新的主要版本升級目標，或升級到該版本的其他可用升級目標之一。如需詳細資訊，請參閱[RDS for MariaDB 不支援引擎版本的資料庫快照升級選項](mariadb-upgrade-snapshot.upgrade-options.md)。

還原升級至新引擎版本的資料庫快照之後，務必測試升級已成功。如需主要版本升級的詳細資訊，請參閱[MySQL 資料庫引擎的升級](USER_UpgradeDBInstance.MariaDB.md)。若要了解如何還原資料庫快照，請參閱[還原至資料庫執行個體](USER_RestoreFromSnapshot.md)。

**注意**  
您無法升級在自動備份程序期間建立的自動資料庫快照。

您可以使用 AWS 管理主控台 AWS CLI或 RDS API 升級資料庫快照。

------
#### [ Console ]

若要使用 升級資料庫快照引擎版本 AWS 管理主控台，請使用下列程序。

**升級資料庫快照**

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

1. 在導覽窗格中，選擇 **Snapshots (快照)**。

1. 選擇您要升級的快照。

1. 針對 **Actions (動作)**，選擇 **Upgrade snapshot (升級快照)**。**Upgrade snapshot (升級快照)** 頁面隨即出現。

1. 選擇要升級到的 **New engine version (新引擎版本)**。

1. 選擇 **Save changes (儲存變更)** 以升級快照。

   升級程序期間，此資料庫快照的所有快照動作會停用。同時，資料庫快照狀態會從**可用**變更為**升級中**，然後在完成時變更為**作用中**。如果資料庫快照因為快照損毀問題而無法升級，狀態會變更為**無法使用**。您無法從此狀態復原快照。
**注意**  
如果資料庫升級失敗，快照會轉返至原始版本的原始狀態。

------
#### [ AWS CLI ]

若要將資料庫快照升級至新的資料庫引擎版本，請執行 AWS CLI [modify-db-snapshot](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-snapshot.html) 命令。

**選項**
+ `--db-snapshot-identifier` – 要升級的資料庫快照識別碼。識別符必須是唯一的 Amazon Resource Name (ARN)。如需詳細資訊，請參閱 [Amazon RDS 中的 Amazon Resource Name (ARN)](USER_Tagging.ARN.md)。
+ `--engine-version` – 資料庫快照會以此引擎版本為目標進行升級。

**Example**  
針對 Linux、macOS 或 Unix：  

```
1. aws rds modify-db-snapshot \
2. 
3.     --db-snapshot-identifier my_db_snapshot \
4.     --engine-version new_version
```
在 Windows 中：  

```
1. aws rds modify-db-snapshot ^
2.     --db-snapshot-identifier my_db_snapshot ^
3.     --engine-version new_version
```

------
#### [ Amazon RDS API ]

若要將資料庫快照升級為新的資料庫引擎版本，請呼叫 RDS API [ModifyDBSnapshot](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBSnapshot.html) 作業。

**Parameters**
+ `DBSnapshotIdentifier` – 要升級的資料庫快照識別碼。識別符必須是唯一的 Amazon Resource Name (ARN)。如需詳細資訊，請參閱 [Amazon RDS 中的 Amazon Resource Name (ARN)](USER_Tagging.ARN.md)。
+ `EngineVersion` – 資料庫快照會以此引擎版本為目標進行升級。

------