8.0 → 8.4 LTS アップグレードの事前チェック (util.checkForServerUpgrade)

コマンド

# State the target version explicitly; the Shell must be the same version as the target or newer
mysqlsh root@db1:3306 -- util check-for-server-upgrade --target-version=8.4.10 --output-format=TEXT
# JSON output for automation, including a my.cnf check
mysqlsh root@db1:3306 -- util check-for-server-upgrade --target-version=8.4.10 --output-format=JSON --config-path=/etc/my.cnf > /tmp/upgrade_check.json

概要

現在のサーバーを対象バージョンと照合する: 削除された変数と権限、デフォルト値が変わったパラメータ、レガシー認証方式、無効な列定義、外部キーおよびパーティションの問題。エラーレベルの指摘事項はアップグレードをブロックする。

使用する場面

すべてのメジャー / LTS アップグレードの前に実行し、指摘事項を修正した後に再実行する。

注意

警告も確認する: 8.4 では innodb_io_capacity (10000)、innodb_log_buffer_size (64 MB)、innodb_adaptive_hash_index (OFF)、innodb_change_buffering (none)、innodb_buffer_pool_instances、group_replication_consistency などのデフォルト値が変わり、性能に影響する可能性がある。現在の動作を維持したい値は my.cnf で固定する。SET_USER_ID などの削除された権限はアップグレード中に削除される。まずレプリカをアップグレードし、負荷下で監視してから切り替える。8.4 から 8.0 へのバイナリダウングレードはサポートされないため、フォールバック手段は論理バックアップか旧バージョンのまま残したレプリカとなる。