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

# 升級 PostgreSQL 資料庫快照引擎版本
<a name="USER_UpgradeDBSnapshot.PostgreSQL"></a>

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

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

您可以升級已加密或未加密的手動資料庫快照。

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

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

如需 RDS for PostgreSQL 資料庫快照的可用引擎版本的詳細資訊，請參閱 [選擇 RDS for PostgreSQL 升級的主要版本](USER_UpgradeDBInstance.PostgreSQL.MajorVersion.md)。

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

## 主控台
<a name="USER_UpgradeDBSnapshot.PostgreSQL.Console"></a>

**升級資料庫快照**

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 (儲存變更)** 以升級快照。

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

## AWS CLI
<a name="USER_UpgradeDBSnapshot.PostgreSQL.CLI"></a>

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

**Parameters**
+ `--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.     --db-snapshot-identifier my_db_snapshot \
3.     --engine-version new_version
```
在 Windows 中：  

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

## RDS API
<a name="USER_UpgradeDBSnapshot.PostgreSQL.API"></a>

若要將資料庫快照升級為新的資料庫引擎版本，請呼叫 Amazon RDS API [ModifyDBSnapshot](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBSnapshot.html) 操作。
+ `DBSnapshotIdentifier` – 要升級的資料庫快照識別符。識別符必須是唯一的 Amazon Resource Name (ARN)。如需詳細資訊，請參閱 [Amazon RDS 中的 Amazon Resource Name (ARN)](USER_Tagging.ARN.md)。
+ `EngineVersion` – 資料庫快照會以此引擎版本為目標進行升級。