mysql_upgrade检查所有数据库中的所有表是否与当前版本的MySQL Server不兼容。mysql_upgrade还会升级系统表，以便您可以利用可能已添加的新特权或功能。

如果mysql_upgrade发现表可能存在不兼容性，则会执行表检查，如果发现问题，则尝试进行表修复。如果表无法修复，请参见第2.11.3节“重建或修复表或索引”以了解手动表修复策略。

每次升级MySQL时都 应该执行mysql_upgrade。

从MySQL 5.7.5开始，mysql_upgrade直接与MySQL服务器通信，向它发送执行升级所需的SQL语句。在5.7.5之前， mysql_upgrade调用 mysql和mysqlcheck 客户端程序来执行所需的操作。对于较旧的实现，如果从Linux上的RPM软件包安装MySQL，则必须安装服务器和客户端RPM。 mysql_upgrade包含在服务器RPM中，但需要客户端RPM，因为后者包含 mysqlcheck。（请参见 第2.5.5节“使用Oracle的RPM包在Linux上安装MySQL”。）

要使用mysql_upgrade，请确保服务器正在运行。然后像这样调用它来检查和修复表并升级系统表：

shell> mysql_upgrade [

]

运行mysql_upgrade后，停止服务器并重新启动它，以便对系统表所做的任何更改生效。

如果有多个MySQL服务器实例在运行，请使用适合连接到所需服务器的连接参数调用 mysql_upgrade。例如，如果服务器在部件3306到3308上的本地主机上运行，​​请通过连接到相应的端口来升级每个服务器：

shell> mysql_upgrade --protocol=tcp -P 3306 [

]
shell> mysql_upgrade --protocol=tcp -P 3307 [

]
shell> mysql_upgrade --protocol=tcp -P 3308 [

]

对于Unix上的本地主机连接，该 --protocol=tcp选项强制使用TCP / IP而不是Unix套接字文件进行连接。

mysql_upgrade: [ERROR] 3161: Storage engine MyISAM is disabled
(Table creation is disallowed).

mysql_upgrade处理所有数据库中的所有表，这可能需要很长时间才能完成。每个表都被锁定，因此在处理其他会话时不可用。检查和维修操作可能非常耗时，特别是对于大型桌子。

有关表检查操作所需的详细信息，请参阅语句FOR UPGRADE选项的 CHECK TABLE说明（请参见 第13.7.2.2节“CHECK TABLE语法”）。

所有已检查和修复的表都标有当前的MySQL版本号。这可以确保下次使用相同版本的服务器运行 mysql_upgrade时，它可以判断是否需要再次检查或修复表。

mysql_upgrade还将MySQL版本号保存mysql_upgrade_info 在数据目录中指定的文件中。这用于快速检查是否已检查此版本的所有表，以便可以跳过表检查。要忽略此文件并执行检查，请使用该 --force选项。

从MySQL 5.7.2开始，mysql_upgrade检查 user表行，对于具有空plugin列的任何行，将该列设置为 'mysql_native_password'或 'mysql_old_password'取决于Password列值的哈希格式。从MySQL 5.7.5开始，支持4.1之前的密码哈希 mysql_old_password并被删除，因此如果凭据使用与该插件兼容的哈希格式， mysql_upgrade会设置空 plugin值'mysql_native_password'。必须手动升级具有4.1之前密码哈希的行。有关帐户升级说明，请参见第6.5.1.3节“迁移远离4.1之前的密码散列和mysql_old_password插件”。

mysql_upgrade不会升级帮助表的内容。有关升级说明，请参见 第5.1.14节“服务器端帮助”。

从MySQL 5.7.7开始，除非使用该--skip-sys-schema选项 调用，否则 mysql_upgrade会安装 sys架构（如果未安装），否则将其升级到当前版本。 如果模式存在但没有 视图，mysql_upgrade会返回错误 ，前提是缺少它表示用户创建的模式： sysversion

Error occurred: A sys schema exists with no sys.version view. If
you have a user created sys schema, this must be renamed for the
upgrade to succeed.

要在这种情况下升级，请先删除或重命名现有 sys架构。

在MySQL 5.7.9及更高版本中，mysql_upgrade 检查InnoDB使用通用分区处理程序创建的分区表，并尝试将它们升级到InnoDB本机分区（在MySQL 5.7.6及更高版本中使用）。（Bug＃76734，Bug＃20727344）同样从MySQL 5.7.9开始，您可以使用SQL语句在mysql客户端中 单独升级这些表ALTER TABLE ... UPGRADE PARTITIONING。

默认情况下，mysql_upgrade作为MySQL root用户运行 。如果root 运行mysql_upgrade时密码已过期 ，您将看到一条消息，指出您的密码已过期且 mysql_upgrade因此失败。要更正此问题，请重置root密码以将其取消，然后再次运行mysql_upgrade。首先，连接到服务器root：

shell> mysql -u root -p
Enter password: ****  <- enter root password here

使用适当的SQL语句重置密码。从MySQL 5.7.6开始，使用ALTER USER：

mysql> ALTER USER USER() IDENTIFIED BY 'root-password';

在5.7.6之前，使用SET PASSWORD：

mysql> SET PASSWORD = PASSWORD('root-password');

然后退出mysql并再次运行 mysql_upgrade：

shell> mysql_upgrade [

]

mysql_upgrade支持下面的选项，可以在命令行或在指定 [mysql_upgrade]与 [client]一个选项文件的组。有关MySQL程序使用的选项文件的信息，请参见 第4.2.6节“使用选项文件”。