mysql システムスキーマ。MySQL サーバーの実行時に必要な情報を格納するテーブルが含まれています (セクション5.3「mysql システムスキーマ」 を参照)。mysql スキーマテーブルは、次の 2 つの広範なカテゴリに分類されます:

その他のスキーマ。一部は組込みであり、サーバーによって 「owned」 とみなされる場合があります。その他のスキーマには、次のものはありません:

データディクショナリのバージョン。 これはデータディクショナリテーブルに適用されます。

サーバーのバージョン (MySQL バージョンとも呼ばれます)。 これは、他のスキーマ内のシステムテーブルおよびオブジェクトに適用されます。

ステップ 1: データディクショナリのアップグレード。

このステップでは、次のアップグレードを行います:

ステップ 2: サーバーのアップグレード。

このステップは、他のすべてのアップグレードタスクで構成されます。 既存の MySQL インストールのサーバーバージョンが、新しくインストールされた MySQL バージョンより低い場合は、他のすべてをアップグレードする必要があります:

MySQL 8.0.16 より前は、mysql_upgrade によって、パフォーマンススキーマ、INFORMATION_SCHEMA およびステップ 2 で説明したオブジェクトがアップグレードされます。 DBA は、サーバーの起動後に mysql_upgrade を手動で起動する必要があります。

MySQL 8.0.16 の時点で、サーバーは以前に mysql_upgrade によって処理されたすべてのタスクを実行します。 アップグレードは 2 ステップの操作のままですが、サーバーは両方を実行するため、プロセスが簡単になります。

オプションを指定しない場合、または --upgrade=AUTO を指定した場合、サーバーは最新でないと判断したものをすべてアップグレードします (ステップ 1 および 2)。

--upgrade=NONE では、サーバーは何もアップグレードしません (ステップ 1 および 2 はスキップします)。ただし、データディクショナリをアップグレードする必要がある場合はエラーで終了します。 古いデータディクショナリを使用してサーバーを実行することはできません。サーバーはサーバーのアップグレードまたは終了を要求します。

--upgrade=MINIMAL を使用すると、サーバーは必要に応じてデータディクショナリ、パフォーマンススキーマおよび INFORMATION_SCHEMA をアップグレードします (ステップ 1)。 このオプションを使用したアップグレード後は、レプリケーション内部が依存するシステムテーブルは更新されず、他の領域でも機能が低下する可能性があるため、Group Replication を起動できないことに注意してください。

--upgrade=FORCE では、サーバーは必要に応じてデータディクショナリ、パフォーマンススキーマおよび INFORMATION_SCHEMA をアップグレードし (ステップ 1)、他のすべてのものを強制的にアップグレードします (ステップ 2)。 サーバーはすべてのスキーマ内のすべてのオブジェクトをチェックするため、このオプションではサーバーの起動に時間がかかります。

通常のアップグレードを実行します (必要に応じてステップ 1 および 2):

必要に応じて、ステップ 1 のみを実行します:

必要に応じてステップ 1 を実行し、ステップ 2 を強制します:

ステップ 2 では、sys スキーマがインストールされていない場合はインストールし、インストールされていない場合は現在のバージョンにアップグレードします。 sys スキーマは存在するが version ビューがない場合、その存在しないという前提で、ユーザーが作成したスキーマがあるとエラーが発生します:

A sys schema exists with no sys.version view. If
you have a user created sys schema, this must be renamed for the
upgrade to succeed.

この場合にアップグレードするには、まず既存の sys スキーマを削除するか、名前を変更します。 その後、アップグレード手順を再度実行します。 (場合によっては、ステップ 2 を強制的に実行する必要があります。)

sys スキーマチェックを防止するには:

ステップ 2 では、必要に応じてすべてのユーザースキーマのすべてのテーブルを処理します。 テーブルチェックの完了には時間がかかる場合があります。 各テーブルはロックされるため、処理中にほかのセッションで使用することはできません。 チェックと修復の処理には時間がかかることがあり、特に大きなテーブルでは長い時間を要する可能性があります。 テーブルチェックでは、CHECK TABLE ステートメントの FOR UPGRADE オプションを使用します。 このオプションに必要な内容の詳細は、セクション13.7.3.2「CHECK TABLE ステートメント」 を参照してください。

テーブルチェックを防止するには:

テーブルチェックを強制するには:

ステップ 2 では、MySQL のバージョン番号をデータディレクトリ内の mysql_upgrade_info という名前のファイルに保存します。

mysql_upgrade_info ファイルを無視して、次のことに関係なくチェックを実行するには:

ステップ 2 では、チェックおよび修復されたすべてのテーブルに現在の MySQL バージョン番号を付けます。 これにより、同じバージョンのサーバーで次回のアップグレードチェックが行われるときに、特定のテーブルを再度チェックまたは修復する必要があるかどうかを判断できます。

ステップ 2 では、システムテーブルをアップグレードして、現在の構造になるようにします。 これは、サーバーと mysql_upgrade のどちらがこのステップを実行するかに関係なく当てはまります。 ヘルプテーブルおよびタイムゾーンテーブルの内容に関して、mysql_upgrade はどちらのタイプのテーブルもロードしませんが、サーバーはヘルプテーブルをロードしますが、タイムゾーンテーブルはロードしません。 (つまり、MySQL 8.0.16 より前では、サーバーはデータディレクトリの初期化時にのみヘルプテーブルをロードします。 MySQL 8.0.16 では、初期化およびアップグレード時にヘルプテーブルがロードされます。) タイムゾーンテーブルをロードする手順はプラットフォームによって異なり、DBA による決定が必要なため、自動的には実行できません。