MySQL は、次の説明に従ってオプションファイルを検索し、存在するものを読み取ります。 使用するオプションファイルが存在しない場合は、前述の適切な方法を使用して作成します。

Windows では、MySQL プログラムは、次のテーブルに示すファイルから起動オプションを指定された順序で読み取ります (最初にリストされたファイルが最初に読み取られ、後で読み取られたファイルが優先されます)。

前述のテーブルで、%WINDIR% は Windows ディレクトリの場所をテーブルしています。 これは一般には C:\WINDOWS です。 次のコマンドを使用して、WINDIR 環境変数の値から正確な場所を判断します:

C:\> echo %WINDIR%

%APPDATA% は、Windows アプリケーションデータディレクトリの値を示します。 次のコマンドを使用して、APPDATA 環境変数の値から正確な場所を判断します:

C:\> echo %APPDATA%

BASEDIR は、MySQL ベースのインストールディレクトリを表します。 MySQL 8.0 が MySQL Installer を使用してインストールされている場合、これは通常 C:\PROGRAMDIR\MySQL\MySQL 8.0 Server です。PROGRAMDIR はプログラムディレクトリ (英語バージョンの Windows では通常 Program Files) を表します。セクション2.3.3「MySQL Installer for Windows」 を参照してください。

DATADIR は、MySQL データディレクトリを表します。 mysqld-auto.cnf の検索に使用されるデフォルト値は、MySQL のコンパイル時に組み込まれたデータディレクトリの場所ですが、mysqld-auto.cnf の処理前に処理されるオプションファイルまたはコマンドラインオプションとして指定された --datadir によって変更できます。

Unix および Unix に似たシステムでは、MySQL プログラムは、次のテーブルに示すファイルから起動オプションを指定された順序で読み取ります (最初にリストされたファイルが最初に読み取られ、後で読み取られたファイルが優先されます)。

前述のテーブルで、~ は現在のユーザーホームディレクトリ ($HOME の値) をテーブルしています。

SYSCONFDIR は、MySQL がビルドされたときに SYSCONFDIR オプションとともに CMake に指定されたディレクトリを示します。 デフォルトでは、これはコンパイル済みのインストールディレクトリの下にある etc ディレクトリです。

MYSQL_HOME はサーバー固有の my.cnf ファイルが存在するディレクトリへのパスを含む環境変数です。 MYSQL_HOME が設定されていない場合に、mysqld_safe プログラムを使用してサーバーを起動すると、mysqld_safe によって BASEDIR(MySQL ベースのインストールディレクトリ) に設定されます。

DATADIR は、MySQL データディレクトリを表します。 mysqld-auto.cnf の検索に使用されるデフォルト値は、MySQL のコンパイル時に組み込まれたデータディレクトリの場所ですが、mysqld-auto.cnf の処理前に処理されるオプションファイルまたはコマンドラインオプションとして指定された --datadir によって変更できます。

特定のオプションの複数のインスタンスが見つかった場合は、最後のインスタンスが優先されますが、1 つの例外があります: mysqld の場合、--user オプションの first インスタンスは、オプションファイルで指定されたユーザーがコマンドラインでオーバーライドされないようにするためのセキュリティ対策として使用されます。

次のオプションファイル構文の説明は、手動で編集するファイルに適用されます。 これにより、mysql_config_editor を使用して作成され暗号化される .mylogin.cnf と、サーバーが JSON 形式で作成する mysqld-auto.cnf が除外されます。

MySQL プログラムを実行する際にコマンド行で指定できるすべての長いオプションは、オプションファイルでも指定できます。 プログラムに対して使用可能なオプションのリストを取得するには、--help オプションを使用してそのプログラムを実行します。 (mysqld では、--verbose および --help を使用します。)

オプションファイルでオプションを指定する構文は、コマンド行構文と同様です (セクション4.2.2.1「コマンド行でのオプションの使用」を参照してください)。 ただしオプションファイルでは、先頭の 2 つのダッシュはオプション名から省略し、1 行で 1 つのオプションのみを指定します。 たとえば、コマンド行での --quick および --host=localhost は、オプションファイルでは独立した行にある quick および host=localhost として指定するようにしてください。 --loose-opt_name 形式のオプションをオプションファイルで指定するには、loose-opt_name として作成します。

オプションファイルの空の行は無視されます。 空でない行は次のいずれかの形式を取ることができます。

先頭および末尾のスペースは、自動的にオプション名および値から削除されます。

オプション値にエスケープシーケンス\b, \t, \n, \r, \\および\s を使用して、バックスペース、タブ、改行、改行、バックスラッシュおよび空白文字を表すことができます。 オプションファイルでは、次のエスケープルールが適用されます:

前述のルールは、リテラルのバックスラッシュを\\または\(有効なエスケープシーケンス文字が続く場合) として指定できることを意味します。

オプションファイルにおけるエスケープシーケンスのルールは、SQL ステートメントにおける文字列リテラルのエスケープシーケンスのルールとは若干異なります。 後者のコンテキストでは、「x」 が有効なエスケープシーケンス文字でない場合、\ x は\ x ではなく 「x」 になります。 セクション9.1.1「文字列リテラル」を参照してください。

オプションファイル値のエスケープのルールは、\ をパス名区切り文字として使用する Windows パス名に特に関係します。 Windows パス名の区切り文字は、エスケープシーケンス文字が続く場合は \\ と記述する必要があります。 そうでない場合は、\\または\として記述できます。 または、/を Windows パス名で使用でき、\として扱われます。 オプションファイルでベースディレクトリ C:\Program Files\MySQL\MySQL Server 8.0 を指定するとします。 これはいくつかの方法で実行できます。 例:

basedir="C:\Program Files\MySQL\MySQL Server 8.0"
basedir="C:\\Program Files\\MySQL\\MySQL Server 8.0"
basedir="C:/Program Files/MySQL/MySQL Server 8.0"
basedir=C:\\Program\sFiles\\MySQL\\MySQL\sServer\s8.0

オプショングループ名がプログラム名と同じである場合、グループ内のオプションは特にそのプログラムに適用されます。 たとえば、[mysqld] グループおよび [mysql] グループは、それぞれ mysqld サーバーおよび mysql クライアントプログラムに適用されます。

[client]オプショングループは、MySQL ディストリビューションで提供されるすべてのクライアントプログラムによって読み取られます (mysqld によってではありません)。 C API を使用するサードパーティのクライアントプログラムでオプションファイルを使用する方法を理解するには、mysql_options() の C API ドキュメントを参照してください。

[client]グループを使用すると、すべてのクライアントに適用するオプションを指定できます。 たとえば、[client]は、サーバーに接続するためのパスワードの指定に使用する適切なグループです。 (ただし、他のユーザーが自分のパスワードを検出できないように、オプションファイルに自分でのみアクセスできることを確認してください。) 使用するすべてのクライアントプログラムが [client] グループを認識しないかぎり、オプションに置かないようにしてください。 そのオプションを理解しないプログラムを実行しようとすると、そのプログラムはエラーメッセージを表示してから終了します。

より一般的なオプショングループを最初にリストし、より具体的なグループを後でリストします。 たとえば、[client]グループはすべてのクライアントプログラムによって読み取られるのに対し、[mysqldump]グループは mysqldump によって読取り専用であるため、より一般的です。 後で指定したオプションは、オプショングループを[client]、[mysqldump]の順に配置するため、mysqldump 固有のオプションで[client]オプションをオーバーライドできます。

一般的なグローバルオプションファイルを次に示します。

[client]
port=3306
socket=/tmp/mysql.sock

[mysqld]
port=3306
socket=/tmp/mysql.sock
key_buffer_size=16M
max_allowed_packet=128M

[mysqldump]
quick

一般的なユーザーオプションファイルを次に示します。

[client]
# The following password is sent to all standard MySQL clients
password="my password"

[mysql]
no-auto-rehash
connect_timeout=2

特定の MySQL リリースシリーズから mysqld サーバーによって読み取り専用になるオプショングループを作成するには、[mysqld-5.7]、[mysqld-8.0]などの名前のグループを使用します。 次のグループは、8.0.x のバージョン番号を持つ MySQL サーバーでのみ sql_mode 設定を使用する必要があることを示しています:

[mysqld-8.0]
sql_mode=TRADITIONAL

オプションファイルで、!include ディレクティブを使用してほかのオプションファイルをインクルードしたり、!includedir を使用して特定のディレクトリでオプションファイルを検索したりできます。 たとえば、/home/mydir/myopt.cnf ファイルをインクルードするには、次のディレクティブを使用します。

!include /home/mydir/myopt.cnf

/home/mydir ディレクトリを検索してそこで見つかったオプションファイルを読み取るには、次のディレクティブを使用します。

!includedir /home/mydir

MySQL では、ディレクトリ内のオプションファイルが読み取られる順序は保証されません。

インクルードされるオプションファイルの内容は、ほかのオプションファイルと同様に記述します。 すなわち、オプションのグループを含み、それぞれの前にオプションが適用されるプログラムを示す [group] 行があるようにしてください。

インクルードされるファイルの処理中、現在のプログラムが検索するグループ内のオプションのみが使用されます。 その他のグループは無視されます。 my.cnf ファイルに次の行が含まれるとします。

!include /home/mydir/myopt.cnf

また、/home/mydir/myopt.cnf は次のようであるとします。

[mysqladmin]
force

[mysqld]
key_buffer_size=16M

my.cnf が mysqld によって処理される場合、/home/mydir/myopt.cnf 内の [mysqld] グループのみが使用されます。 このファイルが mysqladmin によって処理される場合、[mysqladmin] グループのみが使用されます。 このファイルがその他のプログラムによって処理される場合、/home/mydir/myopt.cnf のオプションは使用されません。

!includedir ディレクティブは同様に処理されますが、指名されたディレクトリ内のすべてのオプションファイルが読み取られる点が異なります。

オプションファイルに !include または !includedir ディレクティブが含まれている場合、それらのディレクティブによって指定されたファイルは、ファイル内のどこに指定されていても、オプションファイルが処理されるたびに処理されます。

包含ディレクティブが機能するには、ファイルパスを引用符で囲まず、エスケープシーケンスを使用しないでください。 たとえば、my.ini で提供されている次のステートメントは、オプションファイル myopts.ini を読み取ります:

!include C:/ProgramData/MySQL/MySQL Server/myopts.ini
!include C:\ProgramData\MySQL\MySQL Server\myopts.ini
!include C:\\ProgramData\\MySQL\\MySQL Server\\myopts.ini

Windows では、!include /path/to/extra.ini がファイルの最後の行である場合、末尾に改行が追加されていることを確認してください。それ以外の場合、行は無視されます。