Upgrading a PostgreSQL DB snapshot engine version
With Amazon RDS, you can create a storage volume DB snapshot of your PostgreSQL DB instance. When you create a DB snapshot, the snapshot is based on the engine version used by your Amazon RDS instance. You can upgrade the engine version for your DB snapshots.
After restoring a DB snapshot upgraded to a new engine version, make sure to test that the upgrade was successful. For more information about a major version upgrade, see Upgrades of the RDS for PostgreSQL DB engine. To learn how to restore a DB snapshot, see Restoring to a DB instance.
You can upgrade manual DB snapshots that are either encrypted or not encrypted.
To view the available engine versions for your RDS for PostgreSQL DB snapshot, use the following AWS CLI example.
aws rds describe-db-engine-versions --engine postgres --engine-version
example-engine-version
--query "DBEngineVersions[*].ValidUpgradeTarget[*].{EngineVersion:EngineVersion}" --output text --include-all
For more information about available engine versions for RDS for PostgreSQL DB snapshots, see Choosing a major version for an RDS for PostgreSQL upgrade.
Note
You can't upgrade automated DB snapshots that are created during the automated backup process.
To upgrade a DB snapshot
Sign in to the AWS Management Console and open the Amazon RDS console at https://console.aws.amazon.com/rds/
. -
In the navigation pane, choose Snapshots.
-
Choose the snapshot that you want to upgrade.
-
For Actions, choose Upgrade snapshot. The Upgrade snapshot page appears.
-
Choose the New engine version to upgrade to.
-
Choose Save changes to upgrade the snapshot.
During the upgrade process, all snapshot actions are disabled for this DB snapshot. Also, the DB snapshot status changes from available to upgrading, and then changes to active upon completion. If the DB snapshot can't be upgraded because of snapshot corruption issues, the status changes to unavailable. You can't recover the snapshot from this state.
Note
If the DB snapshot upgrade fails, the snapshot is rolled back to the original state with the original version.
To upgrade a DB snapshot to a new database engine version, use the AWS CLI modify-db-snapshot command.
Parameters
-
--db-snapshot-identifier
– The identifier of the DB snapshot to upgrade. The identifier must be a unique Amazon Resource Name (ARN). For more information, see Amazon Resource Names (ARNs) in Amazon RDS. -
--engine-version
– The engine version to upgrade the DB snapshot to.
Example
For Linux, macOS, or Unix:
aws rds modify-db-snapshot \ --db-snapshot-identifier
my_db_snapshot
\ --engine-versionnew_version
For Windows:
aws rds modify-db-snapshot ^ --db-snapshot-identifier
my_db_snapshot
^ --engine-versionnew_version
To upgrade a DB snapshot to a new database engine version, call the Amazon RDS API ModifyDBSnapshot operation.
-
DBSnapshotIdentifier
– The identifier of the DB snapshot to upgrade. The identifier must be a unique Amazon Resource Name (ARN). For more information, see Amazon Resource Names (ARNs) in Amazon RDS. -
EngineVersion
– The engine version to upgrade the DB snapshot to.