追加された可能性のある新しい権限または機能を利用できるように、mysql スキーマ内のシステムテーブルがアップグレードされます。

パフォーマンススキーマ、INFORMATION_SCHEMA、および sys スキーマがアップグレードされます。

ユーザースキーマを調べます。

--help

短いヘルプメッセージを表示して終了します。

--bind-address=ip_address

複数のネットワークインタフェースを持つコンピュータで、このオプションを使用して、MySQL サーバーへの接続に使用するインタフェースを選択します。

--character-sets-dir=dir_name

文字セットがインストールされているディレクトリ。 セクション10.15「文字セットの構成」を参照してください。

--compress, -C

可能であれば、クライアントとサーバーの間で送信されるすべての情報を圧縮します。 セクション4.2.8「接続圧縮制御」を参照してください。

MySQL 8.0.18 では、このオプションは非推奨です。 MySQL の将来のバージョンで削除されることが予想されます。 レガシー接続圧縮の構成を参照してください。

--compression-algorithms=value

サーバーへの接続に許可される圧縮アルゴリズム。 使用可能なアルゴリズムは、protocol_compression_algorithms システム変数の場合と同じです。 デフォルト値は uncompressed です。

詳細は、セクション4.2.8「接続圧縮制御」を参照してください。

このオプションは MySQL 8.0.18 で追加されました。

--debug[=debug_options], -# [debug_options]

デバッグのログを書き込みます。 一般的な debug_options 文字列は d:t:o,file_name です。 デフォルトは d:t:O,/tmp/mysql_upgrade.trace です。

--debug-check

プログラムの終了時に、デバッグ情報を出力します。

--debug-info, -T

プログラムの終了時に、デバッグ情報とメモリーおよび CPU 使用率の統計を出力します。

--default-auth=plugin

使用するクライアント側認証プラグインに関するヒント。 セクション6.2.17「プラガブル認証」を参照してください。

--default-character-set=charset_name

charset_name をデフォルト文字セットとして使用します。 セクション10.15「文字セットの構成」を参照してください。

--defaults-extra-file=file_name

このオプションファイルは、グローバルオプションファイルのあとに読み取りますが、(UNIX では) ユーザーオプションファイルの前に読み取るようにしてください。 ファイルが存在しないかアクセスできない場合、エラーが発生します。file_name は、フルパス名でなく相対パス名として指定された場合、現行ディレクトリを基準にして解釈されます。

このオプションおよびその他のオプションファイルオプションの詳細は、セクション4.2.2.3「オプションファイルの処理に影響するコマンド行オプション」 を参照してください。

--defaults-file=file_name

指定されたオプションファイルのみ使用します。 ファイルが存在しないかアクセスできない場合、エラーが発生します。file_name は、フルパス名でなく相対パス名として指定された場合、現行ディレクトリを基準にして解釈されます。

このオプションおよびその他のオプションファイルオプションの詳細は、セクション4.2.2.3「オプションファイルの処理に影響するコマンド行オプション」 を参照してください。

--defaults-group-suffix=str

通常のオプショングループだけでなく、通常の名前に str のサフィクスが付いたグループも読み取ります。 たとえば、mysql_upgrade は通常 [client] グループおよび [mysql_upgrade] グループを読み取ります。 --defaults-group-suffix=_other オプションを指定した場合、mysql_upgrade は [client_other] グループおよび [mysql_upgrade_other] グループも読み取ります。

このオプションおよびその他のオプションファイルオプションの詳細は、セクション4.2.2.3「オプションファイルの処理に影響するコマンド行オプション」 を参照してください。

--force

mysql_upgrade_info ファイルを無視し、MySQL の現在のバージョンに対して mysql_upgrade を実行済みでも強制的に実行します。

--get-server-public-key

RSA キーペアベースのパスワード交換に必要な公開キーをサーバーにリクエストします。 このオプションは、caching_sha2_password 認証プラグインで認証されるクライアントに適用されます。 そのプラグインの場合、サーバーは要求されないかぎり公開鍵を送信しません。 このオプションは、そのプラグインで認証されないアカウントでは無視されます。 クライアントがセキュアな接続を使用してサーバーに接続する場合と同様に、RSA ベースのパスワード交換を使用しない場合も無視されます。

--server-public-key-path=file_name が指定され、有効な公開キーファイルが指定されている場合は、--get-server-public-key よりも優先されます。

caching_sha2_password プラグインの詳細は、セクション6.4.1.2「SHA-2 プラガブル認証のキャッシュ」 を参照してください。

--host=host_name, -h host_name

指定されたホストの MySQL サーバーに接続します。

--login-path=name

.mylogin.cnf ログインパスファイルの指定されたログインパスからオプションを読み取ります。 「「ログインパス」」は、接続先の MySQL サーバーおよび認証に使用するアカウントを指定するオプションを含むオプショングループです。 ログインパスファイルを作成または変更するには、mysql_config_editor ユーティリティを使用します。 セクション4.6.7「mysql_config_editor — MySQL 構成ユーティリティー」を参照してください。

このオプションおよびその他のオプションファイルオプションの詳細は、セクション4.2.2.3「オプションファイルの処理に影響するコマンド行オプション」 を参照してください。

--max-allowed-packet=value

クライアント/サーバー通信用のバッファーの最大サイズ。 デフォルトの値は 24M バイトです。 最小値と最大値は 4KB と 2GB です。

--net-buffer-length=value

クライアント/サーバー通信用のバッファーの初期サイズ。 デフォルト値は 1MB − 1KB です。 最小値と最大値は 4KB と 16MB です。

--no-defaults

オプションファイルを読み取りません。 オプションファイルから不明のオプションを読み取ることが原因でプログラムの起動に失敗する場合、--no-defaults を使用して、オプションを読み取らないようにすることができます。

例外として、.mylogin.cnf ファイルは、存在する場合はすべての場合に読み取られます。 これにより、 --no-defaults が使用されたとしても、コマンド行よりも安全な方法でパスワードを指定できます。(.mylogin.cnf は mysql_config_editor ユーティリティーによって作成されます。 セクション4.6.7「mysql_config_editor — MySQL 構成ユーティリティー」を参照してください)。

このオプションおよびその他のオプションファイルオプションの詳細は、セクション4.2.2.3「オプションファイルの処理に影響するコマンド行オプション」 を参照してください。

--password[=password], -p[password]

サーバーへの接続に使用される MySQL アカウントのパスワード。 パスワード値はオプションです。 指定しない場合、mysql_upgrade によってプロンプトが表示されます。 指定する場合は、--password= または -p とそれに続くパスワードの間にスペースなしが存在する必要があります。 パスワードオプションを指定しない場合、デフォルトではパスワードは送信されません。

コマンド行でのパスワード指定は、セキュアでないと考えるべきです。 コマンド行でパスワードを指定しないようにするには、オプションファイルを使用します。 セクション6.1.2.1「パスワードセキュリティーのためのエンドユーザーガイドライン」を参照してください。

パスワードがなく、mysql_upgrade でパスワードの入力を求められないように明示的に指定するには、--skip-password オプションを使用します。

--pipe, -W

Windows で、名前付きパイプを使用してサーバーに接続します。 このオプションは、ネームパイプ接続をサポートするために named_pipe システム変数を有効にしてサーバーを起動した場合にのみ適用されます。 また、接続を行うユーザーは、named_pipe_full_access_group システム変数で指定された Windows グループのメンバーである必要があります。

--plugin-dir=dir_name

プラグインを検索するディレクトリ。 このオプションは、--default-auth オプションを使用して認証プラグインを指定しても、mysql_upgrade がそれを検出しない場合に指定します。 セクション6.2.17「プラガブル認証」を参照してください。

--port=port_num, -P port_num

TCP/IP 接続の場合、使用するポート番号。

--print-defaults

プログラム名と、オプションファイルから受け取るすべてのオプションを出力します。

--protocol={TCP|SOCKET|PIPE|MEMORY}

サーバーへの接続に使用するトランスポートプロトコル。 これは、他の接続パラメータが通常、必要なプロトコル以外のプロトコルを使用する場合に便利です。 許可される値の詳細は、セクション4.2.7「接続トランスポートプロトコル」を参照してください。

--server-public-key-path=file_name

RSA キーペアベースのパスワード交換のためにサーバーが必要とする公開キーのクライアント側コピーを含む、PEM 形式のファイルへのパス名。 このオプションは、sha256_password または caching_sha2_password 認証プラグインで認証されるクライアントに適用されます。 これらのプラグインのいずれかで認証されないアカウントでは、このオプションは無視されます。 クライアントがセキュアな接続を使用してサーバーに接続する場合と同様に、RSA ベースのパスワード交換を使用しない場合も無視されます。

--server-public-key-path=file_name が指定され、有効な公開キーファイルが指定されている場合は、--get-server-public-key よりも優先されます。

sha256_password の場合、このオプションは、MySQL が OpenSSL を使用して構築された場合にのみ適用されます。

sha256_password および caching_sha2_password プラグインの詳細は、セクション6.4.1.3「SHA-256 プラガブル認証」 および セクション6.4.1.2「SHA-2 プラガブル認証のキャッシュ」 を参照してください。

--shared-memory-base-name=name

Windows の場合、共有メモリを使用してローカルサーバに接続するために使用する共有メモリ名。 デフォルト値は MYSQL です。 共有メモリー名では大文字と小文字が区別されます。

このオプションは、共有メモリー接続をサポートするために shared_memory システム変数を有効にしてサーバーを起動した場合にのみ適用されます。

--skip-sys-schema

デフォルトでは、sys スキーマがインストールされていない場合は mysql_upgrade によってインストールされ、それ以外の場合は現在のバージョンにアップグレードされます。 --skip-sys-schema オプションは、この動作を抑止します。

--socket=path, -S path

localhost への接続用に使用する、Unix ソケットファイル、または Windows では使用する名前付きパイプの名前。

Windows では、このオプションは、名前付きパイプ接続をサポートするために named_pipe システム変数を有効にしてサーバーを起動した場合にのみ適用されます。 また、接続を行うユーザーは、named_pipe_full_access_group システム変数で指定された Windows グループのメンバーである必要があります。

--ssl*

--ssl で始まるオプションは、SSL を使用してサーバーに接続するかどうかを指定し、SSL 鍵および証明書を検索する場所を指定します。 暗号化接続のコマンドオプションを参照してください。

--ssl-fips-mode={OFF|ON|STRICT}

クライアント側で FIPS モードを有効にするかどうかを制御します。 --ssl-fips-mode オプションは、暗号化された接続の確立には使用されず、許可する暗号化操作に影響する点で、他の --ssl-xxx オプションとは異なります。 セクション6.8「FIPS のサポート」を参照してください。

次の --ssl-fips-mode 値を使用できます:

--tls-ciphersuites=ciphersuite_list

TLSv1.3 を使用する暗号化された接続に許可される暗号スイート。 値は、コロンで区切られた 1 つ以上の暗号スイート名のリストです。 このオプションに指定できる暗号スイートは、MySQL のコンパイルに使用される SSL ライブラリによって異なります。 詳細は、セクション6.3.2「暗号化された接続 TLS プロトコルおよび暗号」を参照してください。

このオプションは MySQL 8.0.16 で追加されました。

--tls-version=protocol_list

暗号化された接続に許可される TLS プロトコル。 値は、1 つまたは複数のコンマ区切りプロトコル名のリストです。 このオプションに指定できるプロトコルは、MySQL のコンパイルに使用される SSL ライブラリによって異なります。 詳細は、セクション6.3.2「暗号化された接続 TLS プロトコルおよび暗号」を参照してください。

--upgrade-system-tables, -s

mysql スキーマのシステムテーブルのみをアップグレードし、ユーザースキーマはアップグレードしません。

--user=user_name, -u user_name

サーバーへの接続に使用する MySQL アカウントのユーザー名。 デフォルトのユーザー名は root です。

--verbose

冗長モード。 プログラムの動作についてより多くの情報を出力します。

--version-check, -k

mysql_upgrade の接続先のサーバーのバージョンをチェックして、mysql_upgrade がビルドされたバージョンと同じであることを確認します。 そうでない場合は mysql_upgrade は終了します。 このオプションはデフォルトで有効にされています。--skip-version-check を使用して無効化してください。

--write-binlog

デフォルトでは、mysql_upgrade によるバイナリロギングは無効になっています。 アクションをバイナリログに書き込む場合は、--write-binlog を使用してプログラムを起動します。

グローバルトランザクション識別子 (GTID) を有効にして (gtid_mode=ON) サーバーを実行している場合は、mysql_upgrade によるバイナリロギングを有効にしないでください。

--zstd-compression-level=level

zstd 圧縮アルゴリズムを使用するサーバーへの接続に使用する圧縮レベル。 許可されるレベルは 1 から 22 で、大きい値は圧縮レベルの増加を示します。 デフォルトの zstd 圧縮レベルは 3 です。 圧縮レベルの設定は、zstd 圧縮を使用しない接続には影響しません。

詳細は、セクション4.2.8「接続圧縮制御」を参照してください。

このオプションは MySQL 8.0.18 で追加されました。