セクション2.11.1「始める前に」 の情報を確認します。

セクション2.11.5「アップグレード用のインストールの準備」 で事前チェックを完了して、インストールのアップグレード準備が整っていることを確認します。

XA トランザクションを InnoDB で使用する場合は、アップグレードの前に XA RECOVER を実行して、コミットされていない XA トランザクションを確認します。 結果が返された場合は、XA COMMIT または XA ROLLBACK ステートメントを発行して XA トランザクションをコミットまたはロールバックします。

暗号化された InnoDB テーブルスペースがある場合は、次のステートメントを実行してキーリングマスターキーをローテーションします:

ALTER INSTANCE ROTATE INNODB MASTER KEY;

innodb_fast_shutdown を 2 (コールドシャットダウン) に設定して構成した MySQL サーバーを通常実行する場合は、次のいずれかのステートメントを実行して、高速または低速なシャットダウンを実行するように構成します:

SET GLOBAL innodb_fast_shutdown = 1; -- fast shutdown
SET GLOBAL innodb_fast_shutdown = 0; -- slow shutdown

高速停止または低速停止では、InnoDB は undo ログおよびデータファイルを、リリース間でファイル形式が異なる場合に処理できる状態のままにします。

古い MySQL サーバーを停止します。 例:

mysqladmin -u root -p shutdown

MySQL バイナリまたはパッケージをアップグレードします。 バイナリインストールをアップグレードする場合は、新しい MySQL バイナリ配布パッケージを解凍します。 配布の取得とアンパックを参照してください。 パッケージベースのインストールの場合は、新しいパッケージをインストールします。

既存のデータディレクトリを使用して、MySQL 8.0 サーバーを起動します。 例:

mysqld_safe --user=mysql --datadir=/path/to/existing-datadir &

暗号化された InnoDB テーブルスペースがある場合は、--early-plugin-load オプションを使用してキーリングプラグインをロードします。

MySQL 8.0 サーバーを起動すると、データディクショナリテーブルが存在するかどうかが自動的に検出されます。 そうでない場合、サーバーはデータディレクトリにそれらを作成し、メタデータを移入してから、通常の起動シーケンスに進みます。 このプロセス中、サーバーは、データベース、テーブルスペース、システムテーブルとユーザーテーブル、ビュー、ストアドプログラム (ストアドプロシージャと関数、トリガーおよびイベントスケジューライベント) など、すべてのデータベースオブジェクトのメタデータをアップグレードします。 サーバーは、以前にメタデータ記憶域に使用されていたファイルも削除します。 たとえば、MySQL 5.7 から MySQL 8.0 にアップグレードした後、テーブルに .frm ファイルがなくなった場合があります。

このステップが失敗すると、サーバーはすべての変更をデータディレクトリに戻します。 この場合、すべての redo ログファイルを削除し、同じデータディレクトリで MySQL 5.7 サーバーを起動して、エラーの原因を修正する必要があります。 次に、5.7 サーバーの別の低速シャットダウンを実行し、MySQL 8.0 サーバーを起動して再試行します。

前のステップでは、サーバーは必要に応じてデータディクショナリをアップグレードします。 ここで、残りのアップグレード操作を実行する必要があります:

セクション2.11.1「始める前に」 の情報を確認します。

以前の MySQL インストールから既存のデータをエクスポートします:

mysqldump -u root -p
  --add-drop-table --routines --events
  --all-databases --force > data-for-upgrade.sql

古い MySQL サーバーを停止します。 例:

mysqladmin -u root -p shutdown

MySQL 8.0 をインストールします。 インストールの手順については、第2章「MySQL のインストールとアップグレード」を参照してください。

セクション2.10.1「データディレクトリの初期化」 の説明に従って、新しいデータディレクトリを初期化します。 例:

mysqld --initialize --datadir=/path/to/8.0-datadir

画面に表示された一時'root'@'localhost'パスワードをコピーするか、後で使用するためにエラーログに書き込みます。

新しいデータディレクトリを使用して、MySQL 8.0 サーバーを起動します。 例:

mysqld_safe --user=mysql --datadir=/path/to/8.0-datadir &

root パスワードをリセットします:

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

mysql> ALTER USER USER() IDENTIFIED BY 'your new password';

以前に作成したダンプファイルを新しい MySQL サーバーにロードします。 例:

mysql -u root -p --force < data-for-upgrade.sql

残りのアップグレード操作を実行します:

MGM ノードのアップグレード。

データノードを一度に 1 つずつアップグレードします。

API ノードを一度に 1 つずつアップグレードします (MySQL サーバーを含む)。

データディクショナリをインポートします。

--upgrade=MINIMAL オプションを使用して新しいサーバーを起動し、データディクショナリをアップグレードしますが、システムテーブルはアップグレードしません。 これは基本的に、mysql_upgrade を起動せずにサーバーを起動する pre-MySQL 8.0.16 アクションと同じです。

このフェーズを完了するには、MySQL サーバーを NDB に接続する必要があります。 NDB テーブルまたは NDBINFO テーブルが存在し、サーバーがクラスタに接続できない場合は、次のエラーメッセージで終了します:

Failed to Populate DD tables.

システムテーブルをアップグレードします。

MySQL 8.0.16 より前は、DBA は mysql_upgrade クライアントを起動してシステムテーブルをアップグレードします。 MySQL 8.0.16 の時点で、サーバーはこのアクションを実行: システムテーブルをアップグレードするには、--upgrade=MINIMAL オプションを指定せずに個々の mysqld を再起動します。