您可以使用升级检查工具来检查 MySQL 5.7 服务器实例和 MySQL 8.x 服务器实例，这些实例位于 MySQL 8.x 版本系列中的另一个 GA 状态版本，以检查升级的兼容性错误和问题。如果您在不指定 MySQL 服务器实例的情况下调用 checkForServerUpgrade()，则会检查当前连接到全局会话的实例。要查看当前连接的实例，请发出 \status 命令。

升级检查工具可以检查服务器实例的配置文件 (my.cnf 或 my.ini)。该工具检查配置文件中定义但在目标 MySQL 服务器版本中已删除的任何系统变量，以及配置文件中未定义但在目标 MySQL 服务器版本中将具有不同默认值的任何系统变量。对于这些检查，在调用 checkForServerUpgrade() 时，您必须提供配置文件的路径。

升级检查工具可以以文本格式生成其输出，这是默认格式，也可以以 JSON 格式生成，这对于在 DevOps 自动化中使用可能更易于解析和处理。

升级检查工具可以使用 X 协议连接或经典 MySQL 协议连接（使用 TCP 或 Unix 套接字）进行操作。您可以在事先创建连接，也可以将其作为参数指定给该函数。该工具始终创建一个新会话以连接到服务器，因此不会影响 MySQL Shell 全局会话。

用于运行升级检查工具的用户帐户需要 RELOAD、PROCESS 和 SELECT 权限。

升级检查工具具有以下签名

checkForServerUpgrade (ConnectionData connectionData, Dictionary options)

两个参数都是可选的。第一个提供连接数据（如果连接尚不存在），第二个是字典，您可以使用它来指定以下选项

例如，以下命令会验证，然后检查当前连接到全局会话的 MySQL 服务器实例，输出以文本格式

mysqlsh> \status
\status
MySQL Shell version 8.1.0-commercial

...
Server version:               8.1.0-commercial MySQL Enterprise Server - Commercial
...
mysqlsh> util.checkForServerUpgrade()

以下命令检查 URI [email protected]:3306 处的 MySQL 服务器是否要升级到 MySQL 服务器版本 8.1.0。用户密码和配置文件路径作为选项字典的一部分提供，输出以默认文本格式返回

mysqlsh> util.checkForServerUpgrade('[email protected]:3306', 
           {"password":"password", "targetVersion":"8.1.0", "configPath":"C:/ProgramData/MySQL/MySQL Server 8.0/my.ini"})

以下命令检查同一 MySQL 服务器是否要升级到与当前 MySQL Shell 版本号匹配的 MySQL 服务器版本号（默认值），并返回 JSON 输出以供进一步处理

mysqlsh> util.checkForServerUpgrade('[email protected]:3306', 
           {"password":"password", "outputFormat":"JSON", "configPath":"C:/ProgramData/MySQL/MySQL Server 8.0/my.ini"})

您可以使用 mysqlsh 命令界面从命令行启动升级检查工具。有关此语法的详细信息，请参阅 第 5.8 节，“API 命令行集成”。以下示例检查 MySQL 服务器是否要升级到版本 8.0.27，并返回 JSON 输出

mysqlsh -- util checkForServerUpgrade user@localhost:3306 
                   --target-version=8.0.27 --output-format=JSON --config-path=/etc/mysql/my.cnf

连接数据也可以指定为用大括号分组在一起的命名选项，如以下示例所示，该示例还显示了可以使用小写字母和连字符作为方法名，而不是 camelCase

mysqlsh -- util check-for-server-upgrade { --user=user --host=localhost --port=3306 } 
  --target-version=8.0.27 --output-format=JSON --config-path=/etc/mysql/my.cnf

以下示例使用 Unix 套接字连接，并显示了从命令行调用该工具的旧格式，该格式仍然有效

./bin/mysqlsh --socket=/tmp/mysql.sock --user=user -e "util.checkForServerUpgrade()"

要获取升级检查工具的帮助，请发出

mysqlsh> util.help("checkForServerUpgrade")

util.checkForServerUpgrade() 不会返回值。

当您调用升级检查工具时，MySQL Shell 会连接到服务器实例并测试 准备您的安装以进行升级 中描述的设置。输出类似于以下内容

The MySQL server at example.com:3306, version
5.7.33-enterprise-commercial-advanced - MySQL Enterprise Server - Advanced Edition (Commercial),
will now be checked for compatibility issues for upgrade to MySQL 8.0.29...

1) Usage of old temporal type
  No issues found

2) Usage of db objects with names conflicting with new reserved keywords
  Warning: The following objects have names that conflict with new reserved keywords. 
  Ensure queries sent by your applications use `quotes` when referring to them or they will result in errors.
  More information: https://dev.mysqlserver.cn/doc/refman/en/keywords.html

  dbtest.System - Table name
  dbtest.System.JSON_TABLE - Column name
  dbtest.System.cube - Column name

3) Usage of utf8mb3 charset
  Warning: The following objects use the utf8mb3 character set. It is recommended to convert them to use 
  utf8mb4 instead, for improved Unicode support.
  More information: https://dev.mysqlserver.cn/doc/refman/8.0/en/charset-unicode-utf8mb3.html 
 
  dbtest.view1.col1 - column's default character set: utf8 

............................
............................


Errors:   7
Warnings: 36
Notices:  0

7 errors were found. Please correct these issues before upgrading to avoid compatibility issues.

升级检查会执行以下检查

当您使用 outputFormat 字典选项选择 JSON 输出时，升级检查器实用程序返回的 JSON 对象具有以下键值对