您可以使用升级检查工具检查 MySQL 5.7 服务器实例和 MySQL 8.x 服务器实例，以确保它们在 MySQL 8.x 版本系列内的另一个 GA 状态版本中是否存在兼容性错误和问题。如果调用 checkForServerUpgrade() 而不指定 MySQL 服务器实例，则会检查当前连接到全局会话的实例。要查看当前连接的实例，请发出 \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 

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

19) Tables recognized by InnoDB that belong to a different engine
  No issues found

20) Issues reported by 'check table x for upgrade' command
  No issues found

21) New default authentication plugin considerations
  Warning: The new default authentication plugin 'caching_sha2_password' offers
    more secure password hashing than previously used 'mysql_native_password'
    (and consequent improved client connection authentication). However, it also
    has compatibility implications that may affect existing MySQL installations. 
    If your MySQL installation must serve pre-8.0 clients and you encounter
    compatibility issues after upgrading, the simplest way to address those
    issues is to reconfigure the server to revert to the previous default
    authentication plugin (mysql_native_password). For example, use these lines
    in the server option file:
    
    [mysqld]
    default_authentication_plugin=mysql_native_password
    
    However, the setting should be viewed as temporary, not as a long term or
    permanent solution, because it causes new accounts created with the setting
    in effect to forego the improved authentication security.
    If you are using replication please take time to understand how the
    authentication plugin changes may impact you.
  More information:
    https://dev.mysqlserver.cn/doc/refman/8.0/en/upgrading-from-previous-series.html#upgrade-caching-sha2-password-compatibility-issues
    https://dev.mysqlserver.cn/doc/refman/8.0/en/upgrading-from-previous-series.html#upgrade-caching-sha2-password-replication

Errors:   7
Warnings: 36
Notices:  0

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

升级检查器执行以下检查

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