您可以使用升級檢查工具來檢查 MySQL 5.7 伺服器執行個體，以及 MySQL 8.x 版本系列內另一個 GA 狀態版本的 MySQL 8.x 伺服器執行個體，以找出升級的相容性錯誤和問題。如果您在未指定 MySQL 伺服器執行個體的情況下呼叫 checkForServerUpgrade()，則會檢查目前連線至全域工作階段的執行個體。若要查看目前連線的執行個體，請發出 \status 命令。

升級檢查工具可以檢查伺服器執行個體的組態檔 (my.cnf 或 my.ini)。該工具會檢查組態檔中定義但在目標 MySQL 伺服器版本中已移除的任何系統變數，以及組態檔中未定義且在目標 MySQL 伺服器版本中將具有不同預設值的任何系統變數。對於這些檢查，當您呼叫 checkForServerUpgrade() 時，您必須提供組態檔的檔案路徑。

升級檢查工具可以文字格式 (預設) 或 JSON 格式產生其輸出，JSON 格式可能更易於剖析和處理，以便在開發維運自動化中使用。

升級檢查工具可以使用 X Protocol 連線或傳統 MySQL 通訊協定連線，透過 TCP 或 Unix Socket 運作。您可以預先建立連線，或將其指定為函式的引數。該工具始終建立新的工作階段以連線至伺服器，因此 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 user@example.com:3306 的 MySQL 伺服器是否升級至 MySQL 伺服器版本 8.1.0。使用者密碼和組態檔路徑會作為選項字典的一部分提供，且輸出會以預設的文字格式傳回

mysqlsh> util.checkForServerUpgrade('user@example.com: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('user@example.com: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 Socket 連線，並顯示從命令列呼叫工具程式的舊格式，該格式仍然有效

./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://mysqldev.dev.org.tw/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://mysqldev.dev.org.tw/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 物件具有下列索引鍵值組