このセクションでは、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を参照してください。