Upgrading a MySQL DB snapshot - Amazon Relational Database Service

Upgrading a MySQL DB snapshot

With Amazon RDS, you can create a storage volume DB snapshot of your MySQL DB instance. When you create a DB snapshot, the snapshot is based on the engine version used by your Amazon RDS instance. In addition to upgrading the DB engine version of your DB instance, you can also upgrade the engine version for your DB snapshots. For example, you can upgrade DB snapshots created from the MySQL 5.1 engine to DB snapshots for the MySQL 5.5 engine. After restoring a DB snapshot upgraded to a new engine version, you should test that the upgrade was successful. To learn how to test a major version upgrade, see Testing an upgrade. To learn how to restore a DB snapshot, see Restoring from a DB snapshot.

Amazon RDS supports upgrading a MySQL DB snapshot from MySQL 5.1 to MySQL 5.5.

You can upgrade manual DB snapshots, which can be encrypted or not encrypted, from MySQL 5.1 to MySQL 5.5 within the same AWS Region. You can't upgrade automated DB snapshots that are created during the automated backup process.

To upgrade a DB snapshot

  1. Sign in to the AWS Management Console and open the Amazon RDS console at https://console.aws.amazon.com/rds/.

  2. In the navigation pane, choose Snapshots.

  3. For Actions, choose Upgrade snapshot. The Upgrade snapshot page appears.

  4. Choose the New engine version to upgrade to.

  5. 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 Working with 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 <mydbsnapshot> \ --engine-version <new_version>

For Windows:

aws rds modify-db-snapshot ^ --db-snapshot-identifier <mydbsnapshot> ^ --engine-version <new_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 Working with Amazon Resource Names (ARNs) in Amazon RDS.

  • EngineVersion – The engine version to upgrade the DB snapshot to.