Review the information in this section before upgrading. Perform any recommended actions.
Understand what may occur during an upgrade. SeeSection 2.11.3, “What the MySQL Upgrade Process Upgrades”.
Protect your data by creating a backup. The backup should include the
mysql
system database, which contains the MySQL data dictionary tables and system tables. SeeSection 7.2, “Database Backup Methods”.重要的Downgrade from MySQL 8.0 to MySQL 5.7, or from a MySQL 8.0 release to a previous MySQL 8.0 release, is not supported. The only supported alternative is to restore a backup takenbeforeupgrading. It is therefore imperative that you back up your data before starting the upgrade process.
ReviewSection 2.11.2, “Upgrade Paths”to ensure that your intended upgrade path is supported.
ReviewSection 2.11.4, “Changes in MySQL 8.0”for changes that you should be aware of before upgrading. Some changes may require action.
ReviewSection 1.3, “What Is New in MySQL 8.0”for deprecated and removed features. An upgrade may require changes with respect to those features if you use any of them.
ReviewSection 1.4, “Server and Status Variables and Options Added, Deprecated, or Removed in MySQL 8.0”. If you use deprecated or removed variables, an upgrade may require configuration changes.
Review theRelease Notesfor information about fixes, changes, and new features.
If you use replication, reviewSection 17.5.3, “Upgrading a Replication Setup”.
Upgrade procedures vary by platform and how the initial installation was performed. Use the procedure that applies to your current MySQL installation:
For binary and package-based installations on non-Windows platforms, refer toSection 2.11.6, “Upgrading MySQL Binary or Package-based Installations on Unix/Linux”.
NoteFor supported Linux distributions, the preferred method for upgrading package-based installations is to use the MySQL software repositories (MySQL Yum Repository, MySQL APT Repository, and MySQL SLES Repository).
For installations on an Enterprise Linux platform or Fedora using the MySQL Yum Repository, refer toSection 2.11.7, “Upgrading MySQL with the MySQL Yum Repository”.
For installations on Ubuntu using the MySQL APT repository, refer toSection 2.11.8, “Upgrading MySQL with the MySQL APT Repository”.
For installations on SLES using the MySQL SLES repository, refer toSection 2.11.9, “Upgrading MySQL with the MySQL SLES Repository”.
For installations performed using Docker, refer toSection 2.11.11, “Upgrading a Docker Installation of MySQL”.
For installations on Windows, refer toSection 2.11.10, “Upgrading MySQL on Windows”.
If your MySQL installation contains a large amount of data that might take a long time to convert after an in-place upgrade, it may be useful to create a test instance for assessing the conversions that are required and the work involved to perform them. To create a test instance, make a copy of your MySQL instance that contains the
mysql
database and other databases without the data. Run the upgrade procedure on the test instance to assess the work involved to perform the actual data conversion.Rebuilding and reinstalling MySQL language interfaces is recommended when you install or upgrade to a new release of MySQL. This applies to MySQL interfaces such as PHP
mysql
extensions and the PerlDBD::mysql
module.