MySQL 8.0 リファレンスマニュアル


4.9 環境変数

このセクションでは、MySQL によって直接的または間接的に使用される環境変数を示します。 これらの多くは本ドキュメントの別の場所にもあります。

コマンド行のオプションは、オプションファイルおよび環境変数で指定された値よりも優先され、オプションファイルの値は、環境変数の値よりも優先されます。 多くの場合、MySQL の動作を変更するには、環境変数ではなくオプションファイルを使用する方が好ましいといえます。 セクション4.2.2.2「オプションファイルの使用」を参照してください。

変数 説明
AUTHENTICATION_LDAP_CLIENT_LOG クライアント側の LDAP 認証ロギングレベル。
AUTHENTICATION_PAM_LOG PAM 認証プラグインのデバッグロギング設定。
CC C コンパイラの名前 (CMake 実行用)。
CXX C++ コンパイラの名前 (CMake 実行用)。
CC C コンパイラの名前 (CMake 実行用)。
DBI_USER Perl DBI のデフォルトユーザー名。
DBI_TRACE Perl DBI のトレースオプション。
HOME mysql 履歴ファイルのデフォルトのパスは $HOME/.mysql_history です。
LD_RUN_PATH libmysqlclient.so のロケーション指定に使用。
LIBMYSQL_ENABLE_CLEARTEXT_PLUGIN mysql_clear_password 認証プラグインを有効化。セクション6.4.1.4「クライアント側クリアテキストプラガブル認証」を参照してください。
LIBMYSQL_PLUGIN_DIR クライアントプラグインを検索するディレクトリ。
LIBMYSQL_PLUGINS プリロードするクライアントプラグイン。
MYSQL_DEBUG デバッグ中のデバッグトレースオプション。
MYSQL_GROUP_SUFFIX オプショングループのサフィクスの値 (--defaults-group-suffix などの指定)。
MYSQL_HISTFILE mysql 履歴ファイルへのパス。 この変数を設定すると、その値は $HOME/.mysql_history のデフォルトをオーバーライドします。
MYSQL_HISTIGNORE mysql$HOME/.mysql_history または syslog (--syslog が指定されている場合) に記録しないステートメントを指定するパターン。
MYSQL_HOME サーバー固有の my.cnf ファイルが存在するディレクトリへのパス。
MYSQL_HOST mysql コマンド行クライアントが使用するデフォルトのホスト名。
MYSQL_OPENSSL_UDF_DH_BITS_THRESHOLD create_dh_parameters() のキーの最大長。 セクション6.6.2「MySQL Enterprise Encryption の使用方法と例」を参照してください。
MYSQL_OPENSSL_UDF_DSA_BITS_THRESHOLD create_asymmetric_priv_key() の DSA キーの最大長。 セクション6.6.2「MySQL Enterprise Encryption の使用方法と例」を参照してください。
MYSQL_OPENSSL_UDF_RSA_BITS_THRESHOLD create_asymmetric_priv_key() の RSA キーの最大長。 セクション6.6.2「MySQL Enterprise Encryption の使用方法と例」を参照してください。
MYSQL_PS1 mysql コマンド行クライアントで使用するコマンドプロンプト。
MYSQL_PWD mysqld に接続する際のデフォルトのパスワード。 これの使用はセキュアではありません。 表のあとにある注釈を参照してください。
MYSQL_TCP_PORT デフォルトの TCP/IP ポート番号。
MYSQL_TEST_LOGIN_FILE .mylogin.cnf ログインパスファイルの名前。
MYSQL_TEST_TRACE_CRASH テストプロトコルトレースプラグインがクライアントをクラッシュさせるかどうか。 表のあとにある注釈を参照してください。
MYSQL_TEST_TRACE_DEBUG テストプロトコルトレースプラグインが出力を生成するかどうか。 表のあとにある注釈を参照してください。
MYSQL_UNIX_PORT localhost への接続に使用される、デフォルトの Unix ソケットファイル名。
MYSQLX_TCP_PORT X プラグイン のデフォルトの TCP/IP ポート番号。
MYSQLX_UNIX_PORT X プラグイン のデフォルトの Unix ソケットファイル名。localhost への接続に使用されます。
NOTIFY_SOCKET systemd と通信するために mysqld で使用されるソケット。
PATH シェルが MySQL プログラムの検索に使用します。
PKG_CONFIG_PATH mysqlclient.pc pkg-config ファイルの場所。 表のあとにある注釈を参照してください。
TMPDIR 一時ファイルが作成されるディレクトリ。
TZ ローカルタイムゾーンに設定するようにしてください。 セクションB.3.3.7「タイムゾーンの問題」を参照してください。
UMASK ファイルを作成する際のユーザーファイル作成モード。 表のあとにある注釈を参照してください。
UMASK_DIR ディレクトリを作成する際のユーザーディレクトリ作成モード。 表のあとにある注釈を参照してください。
USER mysqld に接続する際の Windows のデフォルトのユーザー名。

mysql の履歴ファイルの詳細は、セクション4.5.1.3「mysql クライアントロギング」を参照してください。

MYSQL_PWD を使用して MySQL パスワードを指定する場合は、極めてセキュアではありませんとみなす必要があり、使用しないでください。 ps のバージョンによっては、実行プロセスの環境を表示するオプションがあります。 一部のシステムで、MYSQL_PWD を設定した場合、パスワードは ps を実行するすべてのユーザーに公開されます。 そのようなバージョンの ps を持たないシステムであっても、ユーザーが処理環境を調査できるほかの方法がないと想定することは賢明ではありません。

MYSQL_PWD は、MySQL 8.0 では非推奨です。将来のバージョンの MySQL では削除される予定です。

MYSQL_TEST_LOGIN_FILE は、ログインパスファイル (mysql_config_editor によって作成されたファイル) のパス名です。 設定されていない場合、デフォルト値は Windows では %APPDATA%\MySQL\.mylogin.cnf ディレクトリ、Windows 以外のシステムでは $HOME/.mylogin.cnf です。 セクション4.6.7「mysql_config_editor — MySQL 構成ユーティリティー」を参照してください。

MYSQL_TEST_TRACE_DEBUG および MYSQL_TEST_TRACE_CRASH 変数は、MySQL がプラグインを有効にして構築されている場合、テストプロトコルトレースクライアントプラグインを制御します。 詳細は、Using the Test Protocol Trace Pluginを参照してください。

UMASK および UMASK_DIR のデフォルト値は、それぞれ 0640 および 0750 です。 MySQL では、UMASK または UMASK_DIR の値がゼロで始まる場合、その値は 8 進数と見なされます。 たとえば、0600 オクタルは 384 桁であるため、UMASK=0600 の設定は UMASK=384 と同等です。

UMASK 変数および UMASK_DIR 変数は、その名前にもかかわらず、マスクではなくモードとして使用されます。

  • UMASK が設定されている場合、mysqld($UMASK | 0600) をファイル作成のモードとして使用し、新しく作成されるファイルのモードは 0600 から 0666 の範囲になります (すべて 8 進数の値)。

  • UMASK_DIR が設定されている場合、mysqld($UMASK_DIR | 0700) をディレクトリ作成のベースモードとして使用し、次に ~(~$UMASK & 0666) との AND が取られます。そのため新しく作成されるファイルのモードは 0700 から 0777 の範囲になります (すべて 8 進数の値)。 AND 演算によってディレクトリモードから読み取り/書き込み権が削除されることがありますが、実行権が削除されることはありません。

セクションB.3.3.1「ファイル権限の問題」も参照してください。

MySQL プログラムの構築に pkg-config を使用する場合は、PKG_CONFIG_PATH の設定が必要になることがあります。 Building C API Client Programs Using pkg-configを参照してください。


関連キーワード:  MYSQL, プログラム, 参照, UMASK, サーバー, 設定, 作成, 接続, セクション, コマンド