セキュリティに関わるオプションは、 項4.6.3. 「セキュリティ関連の mysqld オプション」 を参照してください。

SSL関連オプションは、項4.8.7.3. 「SSL コマンド オプション」 を参照してください。

バイナリ ログを制御するオプションは項4.11.4. 「バイナリ ログ」 を参照してください。

レプリケーションに関連するオプションは項5.1.3. 「レプリケーションのオプションと変数」 を参照してください。

ストレージ エンジン固有のオプションは項13.4.1. 「MyISAM スタートアップオプション」、項13.5.4. 「InnoDB 起動オプションとシステム変数」、項14.6.5.1. 「mysqld の MySQL Cluster 関連コマンド オプション」 などを参照してください。

--help, -?

ショート ヘルプ メッセージを表示、終了。詳細メッセージを参照するには、--verbose と --help オプションを使用する。

--allow-suspicious-udfs

メイン関数が xxx というシンボル (名前) だけのユーザ定義関数をロードでするかどうかを制御する。デフォルトはオフ (無効) で、少なくとも一つの追加関数を持ったユーザ定義関数だけをロードできる。つまり、不正なユーザ定義関数をロードする危険性を防ぐ設定になっている。詳細は 項25.3.4.6. 「User-Defined Function Security Precautions」 を参照のこと。

--ansi

MySQL 構文ではなく、ANSI 準拠の SQL 文を使用する。SQL モードの精密制御には、 --sql-mode オプションを使用する。詳細は 項1.8.3. 「ANSIモードでのMySQLの実行」 および 項4.2.6. 「SQL モード」 を参照のこと。

--basedir=path, -b path

MySQLをインストールしているディレクトリへの基準パス。 パスは通常、このディレクトリに関係する。

big-tables

すべてのテンポラリ セットをファイルに保存して、大きな結果セットにする。ほとんどの 「table full」 エラーがこのオプションで解決するが、メモリ内テーブルだけで足りるクエリの実行速度も遅くする。MySQL 3.23.2 以降、必要に応じて、小さいテンポラリ テーブルにメモリを使用し、大きな結果セットを自動的にディスク テーブルでの保存に切り替える。

--bind-address=IP

バインドする IP アドレス。

--binlog-format={row|statement}

レプリケーションに、レコード ベースとステートメント ベースのどちらを使用するかを指定する。詳細は 項5.1.2. 「レプリケーション フォーマット」 を参照のこと。(MySQL 5.1.5 からの導入)

--binlog-row-event-max-size=N

行ベースのバイナリ ログ イベントの最大サイズ (バイト) を指定する。イベントにグループ化する行のサイズはこの値より小さいことが望ましい。値を256 の倍数とする。デフォルトは 1024。詳細は 項5.1.2. 「レプリケーション フォーマット」 を参照のこと。(MySQL 5.1.5 からの導入)

--bootstrap

mysql_install_db スクリプト実行時に使用するオプション。 MySQL サーバを起動せずに MySQL 権限テーブルを作成できる。

このオプションは、MySQL のコンフィギュレーションに --disable-grant-options オプションを使用していた場合は使えない。詳細は 項2.9.2. 「典型的な configure オプション」 を参照のこと。

--character-sets-dir=path

キャラクタ セットを格納しているディレクトリ。詳細は 項4.10.1. 「データおよびソート用キャラクタ セット」 を参照のこと。

--character-set-client-handshake

クライアント送信のキャラクタ セット情報を無視しない (ようにする) オプション。クライアント情報を無視して、サーバのデフォルトのキャラクタ セットを使用するには、--skip-character-set-client-handshake を使用する (MySQL が MySQL 4.0. のように動作するようにする。)

--character-set-filesystem=charset_name

ファイルシステムのキャラクタ セット。character_set_filesystem のシステム変数を設定する。(MySQL 5.1.6. からの導入)

--character-set-server=charset_name, -C charset_name

デフォルトのキャラクタ セットを設定するときに charset_name を使用する。詳細は 項4.10.1. 「データおよびソート用キャラクタ セット」 を参照のこと。このオプションを使用する場合には、非デフォルトのキャラクタ セットを指定する。照合順序は --collation-server で指定する。

--chroot=path

MySQL サーバ起動中に chroot() のシステム コールを使用して、mysqld の Closed 環境でサーバを起動 (デーモンを配置)する。これは推奨セキィリティ対策。ただし、このオプションを使用すると LOAD DATA INFILE と SELECT ... INTO OUTFILE に制約が加わる。

--collation-server=collation_name

サーバのデフォルトの照合順序を設定するときに collation_name を指定する。詳細は 項4.10.1. 「データおよびソート用キャラクタ セット」 を参照のこと。

--console

--log-error を指定している場合でも、stderr および stdout にエラー ログ メッセージを書き込む。Windows のみに適用。このオプションを使用した場合、 mysqld で、コンソール画面を閉じない (開いたままになる)。

--core-file

mysqld が異常終了した場合に、コア ファイルを作成する。システムによっては、mysqld_safe （mysqld のラッパ） に --core-file-size の指定が必要になる。詳細は 項4.3.1. 「mysqld_safe ? MySQL サーバ スタートアップ スクリプト」 を参照のこと。注意： --user オプションも使用している場合、Solaris などシステムではコア ファイルを作成できない。

--datadir=path, -h path

データ ディレクトリへのパス

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

--with-debug でコンパイルした MySQL を使っている場合、このオプションを使用して mysqld のトレース ファイルを取得できる。debug_options の文字列は、'd:t:o,file_name' という並び (通常)。デフォルトは 'd:t:i:o,mysqld.trace'。詳細は Creating Trace Files を参照。

MySQL 5.1.12 以降、デバッグ サポートに --with-debug を使用して MySQL をコンパイルすると、サーバ起動時に --debug="d,parser_debug" を使用できる。これは、SQL 文の処理に使用している Bison パーサーが、サーバの標準エラー出力にパーサー トレースをダンプすることを起因します。

--default-character-set=charset_name (DEPRECATED)

デフォルトのキャラクタ セットを設定するときに、 charset_name を使用する。このオプションは --character-set-server をうけて、廃止予定である。詳細は 項4.10.1. 「データおよびソート用キャラクタ セット」 を参照のこと。

--default-collation=collation_name

デフォルトの照合順序を設定するときに collation_name を使用する。このオプションは --collation-server をうけて、廃止予定である。詳細は 項4.10.1. 「データおよびソート用キャラクタ セット」 を参照のこと。

--default-storage-engine=type

デフォルトのストーレジ エンジン (テーブル タイプ) を設定する。詳細は 章?13. ストレージエンジンとテーブルタイプ を参照のこと。

--default-table-type=type

このオプションは、--default-storage-engine のシノニム (別名)。

--default-time-zone=timezone

サーバのデフォルト タイム ゾーンを指定する。このオプションで、グローバル スコープの time_zone システム変数をセットする。このオプションを使用しない場合、デフォルトのタイム ゾーンは、システムのタイム ゾーンと同一になる。(system_time_zone システム変数の値)

--delay-key-write[={OFF|ON|ALL}]

遅れたキーの書き込みをどうするかを指定する。キーの書き込みが遅れると、キー バッファを MyISAM テーブルへの書き込み間のフラッシュを抑制する。OFF で遅れたキーの書き込みを無効にする。ON は DELAY_KEY_WRITE オプションで作成したテーブルに対して遅れたキーの書き込みを可能にする。ALL はすべての MyISAM テーブルに対するキー書き込みを遅らせる。詳細は 項6.5.2. 「サーバパラメータのチューニング」 および 項13.4.1. 「MyISAM スタートアップオプション」 を参照のこと。

ノート:この変数を ALL にセットするときに、別のMySQL サーバ、または myisamchk コマンドなどテーブルが使用中の場合は、別のプログラム内から MyISAM デーブルを使用しないでください。インデックス破損の原因になります。

--des-key-file=file_name

DES_ENCRYPT() および DES_DECRYPT() 関数で使用するデフォルトの DES キー をこのファイルから読み取る。

--enable-named-pipe

名前付きパイプ (named pipe) のサポートを有効化する。これは Windows NT、2000、XP、2003 のみで使用可能。mysqld-nt または名前付きパイプの接続をサポートしているサーバで使用可能。

--event-scheduler

イベント スケジューラを無効、有効、開始、停止するオプション (MySQL 5.1.6 からの導入) 注意： 許容値とその動作に関しては MySQL 5.1.11 で変更し、MySQL 5.1.12 でも再度変更している。

詳細は event-scheduler オプション を参照のこと。

--exit-info[=flags], -T [flags]

mysqld サーバのデバッグに使用できる、複数の異なるフラグのビット マスク。このオプションを 使用するには、完全に このオプションを理解していることが必要。

--external-locking

外部ロック (システム ロック) を有効にする。MySQL 4.0 のデフォルトでは無効と設定していた。注意：lockd が完全には機能しないシステム （Linux など） でこのオプションを使用すると、簡単に mysqld がデッドロックになる。このオプションの旧称は --enable-locking。

ノート:MySQL のプロセスにおいて、MyISAM テーブルへの更新を有効にするためにこのオプションを使用する場合、次の条件を満たす必要がある。

この条件を定かにする方法は、常に --external-locking を --delay-key-write=OFF および --query-cache-size=0 を併用することである。(様々なステップにおいて、前述オプションを組み合わせることが有用であることから、デフォルトでは設定をしていない。)

--flush

それぞれの SQL コマンドの実行後に、ディスクへ変更のすべてをフラッシュ (同期) する。通常、MySQL はそれぞれの SQL コマンドの後に、変更だけをディクスに書き込み、ディスクへの同期処理はオペレーティング システムに任せている。詳細は 項B.1.4.2. 「What to Do If MySQL Keeps Crashing」 を参照のこと。

--general-log[={0|1}]

--log または -l オプションを与えた場合に、初期のログ状態を指定する。引数がない、または 0 の場合、--general-log オプションがログを無効化する。引数を省略または 1 とした場合、ログを有効化する。--log または -l を指定しない場合、--general-log の効果はない。(MySQL 5.1.12 からの導入)

--init-file=file_name

サーバ起動時にこのファイルから読み込んだ SQL コマンドを実行する。それぞれのコマンドはシングル ライン (一行) で、コメントを含まないものとする。

このオプションは、MySQL のコンフィギュレーションに --disable-grant-options オプションを使用している場合は使えない。詳細は 項2.9.2. 「典型的な configure オプション」 を参照のこと。

--innodb-xxx

InnoDB オプションは 項13.5.4. 「InnoDB 起動オプションとシステム変数」 を参照のこと。

--language=lang_name, -L lang_name

クライアントのエラー メッセージに使用する言語。lang_name は言語名またはフルパスで指定できる (言語情報を格納するディレクトリ）。詳細は 項4.10.2. 「英語以外のエラーメッセージ」 を参照のこと。

--large-pages

オペレーティング システムによっては、デフォルト (4KB) よりも大きいメモリ ページをサポートしている。サポートの実装はハードウェアやOSに依存する。大量のメモリ アクセスがあるアプリケーションの場合には、大きなメモリ ページを使用して、パフォーマンスを改善できる可能性がある。つまり トランスレーション・ルックアサイド・バッファ (TLB; Translation Lookaside Buffer) のミスが減る。

現在、MySQL は Linux 実装だけをサポートしている。Linux ではこれを HugeTLB と呼ぶ。 FreeBSD や Solaris、その他の OS でのサポートは計画中である。

Linux で大きなページを使用するには、HugeTLB メモリ プールを設定する必要がある。リファレンスとして、Linux カーネル ソースの hugetlbpage.txt ファイルを参照のこと。

このオプションのデフォルトは無効と設定している。

--log[=file_name], -l [file_name]

一般クエリ ログを有効化する。一般クエリ ログにはクライアントとの接続記録とクライアントから受信した SQL文のエントリーをログしている。MySQL 5.1.6 から、ログ出力先は --log-output オプションで選択できる。MySQL 5.1.6 以前は、ログはクエリ ログ ファイルに記録している。このファイル名を省略すると、MySQL でファイル名に host_name.log を使用する。詳細は 項4.11.1. 「一般クエリとスロー クエリのログ出力先の選択」 および 項4.11.3. 「一般クエリ ログ」 を参照のこと。

--log-bin[=base_name]

バイナリ ログを有効化する。サーバがデータを変更するクエリをすべてバイナリ ログに記録する。これは、バックアップおよびレプリケーション用に使用できる。詳細は 項4.11.4. 「バイナリ ログ」 を参照のこと。

オプション値を指定すると、それはログ順序のベース名 (basename) になる。サーバはベース名に数値のサフィックスを与えた配列でバイナリ ログ ファイルを作成する。ベース名指定は推奨事項である (項B.1.8.1. 「Open Issues in MySQL」 を参照のこと)。指定がない場合、MySQL で host_name-bin をベース名として扱う。

--log-bin-index[=file_name]

バイナリ ログ ファイル名のインデックス ファイルを指定する。詳細は 項4.11.4. 「バイナリ ログ」 を参照のこと。ファイル名を省略する場合に、--log-bin で名前を指定しないときには、MySQL で、host_name-bin.index をファイル名として扱う。

--log-bin-trust-function-creators[={0|1}]

引数なし、または 1 で、このオプションは log_bin_trust_function_creators システム変数を 1 と設定する。引数 0 の場合は、システム変数を 0 にセットする。log_bin_trust_function_creators はMySQL の格納関数 (stored function) の動作に制約を与える。詳細は 項17.4. 「ストアドルーチンとトリガのバイナリログ」. を参照のこと。

--log-error[=file_name]

エラーと起動メッセージをファイルに記録する。詳細は 項4.11.2. 「エラー ログ」 を参照のこと。ファイル名を省略する場合、MySQL で host_name.err を使用する。ファイル名に拡張子がない場合は、サーバで .err という拡張子を加える。

--log-isam[=file_name]

すべての MyISAM の変更をファイルに記録する。MyISAM をデバッグするときにだけ使用する。

--log-long-format (DEPRECATED)

追加情報をログ ファイルに記録する（更新ログ、バイナリ更新ログ、スロー クエリ ログなど、有効化しているログのすべて）。たとえば、クエリのユーザ名とタイム スタンプを記録する。このオプションは --log-short-format の説明と同じ理由で、廃止となり、デフォルト設定になった。一方で、MySQL インデックスを使用しないクエリをスロー クエリ ログに記録するための --log-queries-not-using-indexes オプションが利用可能になっている。

--log-output[=value,...]

このオプションで、一般クエリ ログとスロー クエリ ログの出力先を決める。オプション値は TABLE、FILE、NONE など、一つ以上の文字 (words) で与える。このオプションに値がない場合、つまりデフォルトでは、TABLE で、mysql データベースのgeneral_log および slow_log テーブルに記録する。FILE は、ログ ファイルに記録する。FILE のロギングでは、 --log および -slow-log のオプションでログ ファイルの場所を決定する。NONE はロギングを無効にする。NONE がオプション値にある場合は、どの文字よりも優位になる。オプションで TABLE および FILE 両方のログ出力先を選択できる。

ノート： このオプションはログ出力先を選択するが、ログ出力には関与しない。ログ出力を有効にするには、--log および --log-slow-queries オプションを使用する。詳細は 項4.11.1. 「一般クエリとスロー クエリのログ出力先の選択」 を参照のこと。

--log-output オプションは MySQL 5.1.6 で導入した。

--log-queries-not-using-indexes

このオプションを --log-slow-queries として使用する場合、インデックスを使用しないクエリはスロー クエリ ログで記録する。詳細は 項4.11.5. 「スロー クエリ ログ」 を参照のこと。

--log-short-format

ログ ファイル （更新ログ、バイナリ更新ログ、スロークエリログなど、有効化しているログのすべて） で記録する情報が少なくなる。たとえば、クエリのユーザ名とタイム スタンプを記録しなくなる。

--log-slow-admin-statements

OPTIMIZE TABLE、ANALYZE TABLE、ALTER TABLEなど、時間がかかる管理系 SQL 文をスロー クエリ ログに出力する。

--log-slow-queries[=file_name]

スロー クエリ ログを有効化する。実行時間が long_query_time 秒以上かかるクエリをすべてスロー ログ ファイルとして記録する。詳細については、--log-long-format オプションおよび --log-short-format オプションの説明を参照のこと。

MySQL 5.1.6 以降でのログ出力先は --log-output で選択できる。MySQL 5.1.6 以前の場合は、ロギングはスロー クエリ ログ ファイルで行なう。このファイル名を省略すると、MySQL で host_name-slow.log をファイル名として扱う。詳細は 項4.11.1. 「一般クエリとスロー クエリのログ出力先の選択」 および 項4.11.5. 「スロー クエリ ログ」 を参照のこと。

--log-tc=file_name

バイナリ ログを無効にすると、複数のストレージ エンジンに影響を与える XA トランザクションに対する、メモリ マップのトランザクション コーディネータのログ ファイルの名前。デフォルト名は tc.log 。このファイルをフルパスで指定しない場合には、データ ディレクトリ下での作成になる。現段階ではこのオプションは使用していない。

--log-tc-size=size

メモリ マップのトランザクションのコーディネータのログのバイト サイズ。デフォルト サイズは 24 KB。

--log-warnings[=level], -W [level]

Aborted connection... などの警告をエラー ログに出力する。このオプションを有効にしておく (推奨) と、レプリケーションを行う場合に、ネットワークの問題や再接続のメッセージに関する詳細を得ることができる。このオプションは、デフォルトで有効化 (1) していて、デフォルトの level 値を省略する場合は、1 になる。このオプションを無効化するには、--log-warnings=0 を使用する。値を 1 より大きくすると、エラー ログで通信エラー (Aborted connections) を記録することになる。詳細は 項B.1.2.10. 「Communication Errors and Aborted Connections」 を参照のこと。

--low-priority-updates

テーブル変更操作で、選択よりも優先順位を下げる (INSERT、REPLACE、DELETE、UPDATE など)。 {INSERT | REPLACE | DELETE | UPDATE} LOW_PRIORITY ... を使用して 1 つのクエリだけ優先順位を低くしたり、SET LOW_PRIORITY_UPDATES=1 を使用して 1 つのスレッド内での優先順位を変更することができる。詳細は 項6.3.2. 「テーブルロック関連の問題」 を参照のこと。

--memlock

メモリ内の mysqld プロセスをロックする。これは、使用しているシステムが mlockall() システム コールをサポートしている場合（Solaris など）に使用可能。たとえば、オペレーティング システムが原因で mysqld のスワップが発生するという問題がある場合、その解決に役立つ。注意: このオプションを使用するには、サーバを root として起動することが必要になるが、これは安全ではない。詳細は 項4.6.5. 「ユーザによる MySQL の実行」 を参照のこと。.

--myisam-recover[=option[,option]...]]

MyISAM のストレージ エンジン のリカバリ モードをセットする。オプションは、DEFAULT、BACKUP、FORCE、QUICK の任意の組み合わせ。複数の値を指定するにはカンマで区切る。このオプションを無効にするには、これを明示的に "" を使用する。このオプションを使用すると、mysqld はテーブルを開く一方で、MyISAM テーブルを開き、テーブルにクラッシュのマークが付いていないか、つまりテーブルを正しく閉じているかどうかをチェックする。（これは外部ロックを無効にした状態で稼動している場合にだけ機能する）。テーブルにクラッシュ マークが付いていた場合、mysqld はテーブルをチェックし、テーブルが破損していた場合は、mysqld で修復を試みる。

次のオプションで、修復方法を決定する。

サーバはテーブルを自動的に修復する前に、エラー ログに修復するというノートを書き込む。BACKUP,FORCE を使用すると、ユーザの介入をなくして、ほとんどすべての問題をリカバリできる。このやり方は、テーブルの修復を強制的に行うことになるため、レコードを若干削除してしまう可能性を伴うが、古いデータ ファイルがバックアップとして残るので後で調べることができる。

詳細は 項13.4.1. 「MyISAM スタートアップオプション」 を参照のこと。

--ndb-connectstring=connect_string

NDB ストレージ エンジンを使用している場合、接続文字列オプションを設定して、クラスタ コンフィギュレーションを渡しているマネージメント サーバをポイントアウトできる。構文は 項14.4.4.2. 「クラスタの　接続文字列」 を参照のこと。

--ndbcluster

NDB Cluster ストレージ エンジンへのサポートをバイナリに組み込んでいる場合、このオプションがエンジンを有効化する。デフォルト設定では無効になっている。詳細は 章?14. MySQL Cluster を参照のこと。

--old-passwords

新たなパスワードに古いパスワード形式でのハッシュ生成を強制する。(MySQL4.0 以前のパスワードを強制する。) これは、サーバが古いクライアント プログラムをサポートする必要がある場合に有用である。詳細は 項4.7.9. 「MySQL 4.1 のパスワードハッシュ」 を参照のこと。

--one-thread

(Linux でのデバッグ) でスレッドを一つだけにする。サーバでのデバッグが有効化している場合にだけ使用できる。詳細は Debugging a MySQL Server を参照こと。

--open-files-limit=count

mysqld で使用可能なファイル記述子の数を変更する。これが設定されていない、または 0 で設定する場合、mysqld は、setrlimit() で使用している値を使用してファイル記述子をリザーブする。値が 0 の場合、mysqld は max_connections×5 または max_connections + table_open_cache×2 のどちらか大きい値をファイル数としてリザーブする。mysqld で Too many open files のエラーが出る場合、この値を大きくする。

--pid-file=path

プロセス ID (PID) ファイルのパス。mysqld_safe など、別プログラムでサーバの PID を指定するときに使用するファイルのこと。

--port=port_num, -P port_num

TCP/IP 接続時に使用するポート番号を指定する。ポート番号は 1024 以上にする。サーバが root システム ユーザで立ち上がっている場合はこの限りではない。

--port-open-timeout=num

このオプションは TCP/IP ポートが開かない場合に、何秒待機するかを示す。システムによっては、サーバ停止後、すぐには TCP/IP ポートを使用できない。サーバを終了した直後に再起動すると、サーバは失敗する可能性のあるポートを再び開けようとする。デフォルト設定では待機しない、と指定している。(MySQL 5.1.5 からの導入)

--safe-mode

いくつかの最適化ステージをスキップする。

--safe-show-database (DEPRECATED)

詳細は 項4.7.3. 「MySQL 提供の権限」 を参照のこと。

--safe-user-create

これを有効化した場合、ユーザに mysql.user テーブルまたはそのテーブル内のカラムに対する INSERT 権限がなければ、GRANT コマンドを使用して新規ユーザを作成できなくなる。

--secure-auth

クライアントからの古いパスワード形式 (（MySQL4.1 より前の形式）) による認証を許可しない。

--shared-memory

ローカル クライアントとの共有メモリ接続を有効化する。 このオプションは Windows にだけ使用できる。

--shared-memory-base-name=name

共有メモリ接続で使用する共有メモリの名前を指定します。 このオプションは Windows にだけ使用できる。デフォルトの名前は MYSQL。この名前は大文字と小文字を区別する。

--skip-concurrent-insert

MyISAM テーブルに対する SELECT 文と INSERT 文の同時実行を無効化する。このオプションは、この動作に関してバグの可能性があるときにだけ有効化する。詳細は 項6.3.3. 「同時挿入」 を参照のこと。

--skip-external-locking

外部ロック (システム ロック) を使わないようにする。外部ロックが無効化している場合に、myisamchk を使用するときには、サーバをシャットダウンする (項6.5.1. 「システム、コンパイル時間およびスタートアップパラメータのチューニング」 参照)。外部ロックを回避すには。 これを不要にするには、CHECK TABLE および REPAIR TABLE 文をチェックに使用して、MyISAM テーブルを修正する。

MySQL 4.0 以降、外部ロックのデフォルト設定では、無効化している。

--skip-grant-tables

サーバが一切の権限システムを使用しないようにする。つまり、誰でも すべてのデータベースにフルアクセスできる ようになる。サーバ実行中に、権限テーブルの行使を再開するには、mysqladmin flush-privileges または mysqladmin reload をシステム シェルから実行するか、またはサーバ接続後に MySQL FLUSH PRIVILEGES ステートメントを発行する。このオプションはまた、プラグインとユーザ定義関数 (UDF) のロードを抑制する。

このオプションは、MySQL のコンフィギュレーションに --disable-grant-options オプションを使用している場合は使えない。詳細は 項2.9.2. 「典型的な configure オプション」 を参照のこと。

--skip-host-cache

name-to-IP の解決に、ホスト名のキャッシュを使用せず、接続ごとに DNS サーバに対しクエリを発行する。詳細は 項6.5.6. 「MySQLの DNS の使用」 を参照のこと。

--skip-innodb

InnoDB ストレージ エンジンを無効にする。メモリとディスク領域の節約および演算処理のスピードアップに役立つ。InnoDB テーブルを必要とする場合は、このオプションを使用しない。

--skip-name-resolve

(MySQLでのDNS逆引きを無効にする。) クライアント接続のチェックに、IPアドレスからホスト名を割り出す。このオプションを使用する場合には、権限テーブルの Host カラム値すべてが IP アドレスまたは localhost であることが必要。詳細は 項6.5.6. 「MySQLの DNS の使用」 を参照のこと。

--skip-ndbcluster

NDB Cluster ストレージ エンジンを無効にする。NDB Cluster ストレージ エンジン サポートを投じたバイナリではデフォルトである。--ndbcluster オプションを明示的に与えると、サーバはこのストレージ エンジンのメモリや別リソースを配分する。使用例に関しては 項14.4.3. 「MySQL Cluster の簡単なテストの設定」 を参照のこと。

--skip-networking

TCP ポートを一切使用しない。mysqld とのやり取りはすべて、名前付きパイプ、共有メモリ ( Windows) または Unix ソケット ファイル (Unix) を介して行う必要がある。ローカルからの接続要求のみを許可しているシステムにおいては、特にこのオプションを使用する (推奨)。詳細は 項6.5.6. 「MySQLの DNS の使用」 を参照のこと。

--ssl*

--ssl で始まるオプションは、SSL経由での接続をクライアントに許可するかどうかを指定し、SSL キーと証明書 がどこにあるかを示す。詳細は 項4.8.7.3. 「SSL コマンド オプション」 を参照のこと。

--standalone

Windows NT システム専用。MySQL サーバをサービスとして起動せずにスタンドアロンで起動する。

--symbolic-links, --skip-symbolic-links

シンボリック リンクのサポートを有効化または無効化する。このオプションは、Windows と Unix では効果が異なる。

--skip-safemalloc

MySQL を --with-debug=full で設定する場合、すべてのプログラムが、メモリの割り当て時と解放時に必ずメモリのオーバーランをチェックする。このチェックには時間がかかるため、このチェックが不要のサーバに対しては、--skip-safemalloc オプションを使用して、チェックをスキップできる。

--skip-show-database

ユーザが SHOW DATABASES 権限を持っていない場合に、SHOW DATABASES コマンドを無効化する。ステートメントはすべてのデータベース名を表示する。このオプションをセットしない場合、SHOW DATABASES はすべてのユーザが利用できるようになるが、ユーザが SHOW DATABASES 権限、またはそのデータベースに関する何らかの権限を持っているときには、それぞれのデータベース名だけを表示する。注意：すべての グローバル権限がデータベースに対する権限になる。

--skip-stack-trace

スタック トレースを書き込まないようにする。このオプションは、デバッガで mysqld を実行するときに役立つ。システムによっては、コア ファイルを取得するためにこのオプションの使用が必要な場合がある。詳細は Debugging a MySQL Server を参照のこと。

--skip-thread-priority

応答時間を短くするため、スレッド優先度の使用を無効化する。

--slow-query-log[={0|1}]

--log-slow-queries オプションで、イニシャルのログ状態を指定する。引数がない、または 0 の場合、--slow-query-log オプションがログを無効化する。省略または 1 を引数とした場合、このオプションはログを有効化する。--log または -l を指定しない場合、--slow-query-log の効果はない。(MySQL 5.1.12 での導入)

--socket=path

Unix では、ローカル接続に使用するソケットファイルを指定する。デフォルトは /tmp/mysql.sock 。Windows では、名前付きパイプのローカル接続用パイプ名を指定する。デフォルトは MySQL (大小文字の区別なし)。

--sql-mode=value[,value[,value...]]

SQL モードを設定する。詳細は 項4.2.6. 「SQL モード」 を参照のこと。

--sysdate-is-now

デフォルトの SYSDATE() が実行タイムを返す。これは実行を開始するステートメントのタイムではない。NOW() の動作によって異なる。このオプションを使用すると、SYSDATE() が NOW() のエイリアスになる。バイナリ ロギングやレプリケーションの実装に関しては、項11.5. 「日付時刻関数」 で SYSDATE() 用の説明と、項12.5.3. 「SET 構文」 で SET TIMESTAMP 用の説明を参照のこと。

(MySQL 5.1.8 での追加)

--tc-heuristic-recover={COMMIT|ROLLBACK}

ヒューリスティック のリカバリ プロセスで使用する決定型 (発見的方法)。現段階では、このオプションは未使用である。

--temp-pool

このオプションを使用すると、サーバが作成する大部分のテンポラリ ファイルに、それぞれ一意の名前ではなく、小さな名前のセットを使用する。これで、名前が異なる新規作成ファイルが多い場合に、それを Linux カーネルが処理するときの問題を回避する。Linux では、メモリがディスク キャッシュではなく、ディレクトリ エントリ キャッシュへの割り当てになるため、従来の動作ではメモリの 「リーク」 が発生しやすい。

--transaction-isolation=level

デフォルトのトランザクション隔離レベルを指定する。level 値は、READ-UNCOMMITTED、READ-COMMITTED、REPEATABLE-READ、SERIALIZABLE などになり得る。詳細は 項12.4.6. 「SET TRANSACTION 構文」 を参照のこと。

--tmpdir=path, -t path

テンポラリ ファイル作成に使用するディレクトリのパス。テンポラリ ファイルを保存するには小さすぎるパーティション上にデフォルトの /tmp ディレクトリがある場合、このオプションが役に立つ。このオプションではラウンド ロビン方式のパスを使用できる。Unix ではコロン（‘:’）を、Windows、NetWare、OS/2 ではセミコロン（‘;’）でパスを区切る。MySQL サーバがレプリケーション スレーブとして機能している場合は、メモリベースのファイルシステムのディレクトリや、サーバ ホストのリブートでクリアするディレクトリを指すときには、--tmpdir を設定しない。テンポラリ ファイルのストレージ位置に関しては、項B.1.4.4. 「Where MySQL Stores Temporary Files」 を参照のこと。スレーブは、マシンがリブートしてもテンポラリ テーブルのレプリケーション、または LOAD DATA INFILE のレプリケーション処理を続行するためにテンポラリファイルを必要とする。サーバの再起動時に、テンポラリ ファイル ディレクトリのファイルが消えた場合、レプリケーションは失敗に終わる。

--user={user_name|user_id}, -u {user_name|user_id}

mysqld サーバを、user_name (名前)、または user_id (数字のユーザ ID) を保持するユーザで実行する。ここでの 「ユーザ」 は、権限テーブルにリストしている MySQL ユーザではなく、システム ログイン アカウントのこと）。

mysqld を root アカウントで起動する場合には、必須 のオプションである。起動シーケンス中にサーバがそのユーザ ID を変更し、root ではなく、特定のユーザで実行するようになる。詳細は 項4.6.1. 「セキュリティ ガイドライン」 を参照のこと。

セキュリティ ホールを回避するため、つまりユーザが --user=root オプションを my.cnf ファイルに追加することが原因で、その結果、サーバが root として稼動できないようにするために、mysqld で最初に指定した --user オプションだけを使用し、複数の --user オプションがあった場合に警告を生成する。/etc/my.cnf および $MYSQL_HOME/my.cnf 内のオプションは、コマンドラインのオプションより先に処理することになるため、--user オプションを /etc/my.cnf に含めた上で、root 以外の値を指定する (推奨)。/etc/my.cnf 内のオプションが他の --user オプションよりも先に検出することになるので、サーバは確実に root 以外のユーザが実行することになり、別の --user オプションを検地すると警告を出す。

--version, -V

バージョン情報を表示して、終了する。

サーバで使用しているコンパイルのデフォルト値や、読み込むオプション ファイルの所在を確認するコマンド

mysqld --verbose --help

サーバが元にするコンパイルのデフォルト値や、オプション ファイルの設定がどうなっているか (無視するかどうか) を確認するコマンド

mysqld --no-defaults --verbose --help

実行中のサーバでカレント値を確認するには、SHOW VARIABLES ステートメントを使用すること。

項4.2.4. 「システム変数の使用」 では、システム変数値に関する構文規則と表示方法について説明します。

項4.2.4.2. 「動的システム変数」 では、ランタイムで設定できる変数をリストしています。

システム変数の調整に関する情報は 項6.5.2. 「サーバパラメータのチューニング」 を参照してください。

項13.5.4. 「InnoDB 起動オプションとシステム変数」 では、InnoDB システム変数をリストしています。

auto_increment_increment

auto_increment_increment と auto_increment_offset はマスタからマスタへのレプリケーションに使用する。AUTO_INCREMENT カラムの操作の制御に使用できる。この変数には、グローバルまたはローカルで設定でき、それぞれで 1 から 65,535 までの整数を使用できる。これら 2 種類の変数のどちらかを 0 に設定すると、1 での設定したものとの解釈になる。65,535 より大きな整数、あるいは 0 ではない数字でこれらの変数のどちらかを設定すると、65,535 で設定したものとの解釈になる。auto_increment_increment または auto_increment_offsetに、整数以外の値を使用すると、反映できずエラーになり、変数の実際の値 (デフォルト) のままになる。

重要 auto_increment_increment と auto_increment_offset は MySQL Cluster レプリケーションには使用しないでください。MySQL Cluster レプリケーションでこの 2 つの変数を使用すると、予期せぬエラーまたは回復不能な状態にある可能性があります。そのため、Cluster レプリケーションでの この 2 つの変数においては、サポートしていません。

これら 2 つの変数は AUTO_INCREMENT カラムの動作に次のように影響する。

ここで、これら変数のどちらか、あるいは両方が変更して、新規の行をテーブルの AUTO_INCREMENT カラムに挿入していなければならない。結果は直感的のようにも思えるが、これは既にカラムに存在している値を無視して、AUTO_INCREMENT 値で計算している。つまり、挿入した値が AUTO_INCREMENT カラムの最大値よりも大きいシリーズの最小値であることが原因である。つまり、シリーズが次のように計算したことに起因する。

auto_increment_offset + N × auto_increment_increment

N が [1, 2, 3, ...] のシリーズの正の整数。たとえば次の例示の通り。

mysql> SHOW VARIABLES LIKE 'auto_inc%';
+--------------------------+-------+
| Variable_name            | Value |
+--------------------------+-------+
| auto_increment_increment | 10    |
| auto_increment_offset    | 5     |
+--------------------------+-------+
2 rows in set (0.00 sec)

mysql> SELECT col FROM autoinc1;
+-----+
| col |
+-----+
|   1 |
|  11 |
|  21 |
|  31 |
+-----+
4 rows in set (0.00 sec)

mysql> INSERT INTO autoinc1 VALUES (NULL), (NULL), (NULL), (NULL);
Query OK, 4 rows affected (0.00 sec)
Records: 4  Duplicates: 0  Warnings: 0

mysql> SELECT col FROM autoinc1;
+-----+
| col |
+-----+
|   1 |
|  11 |
|  21 |
|  31 |
|  35 |
|  45 |
|  55 |
|  65 |
+-----+
8 rows in set (0.00 sec)

auto_increment_increment と auto_increment_offset で示している値は、5 + N × 10 のシリーズを生成する。つまり、[5, 15, 25, 35, 45, ...] である。INSERT 前の col カラムの最大値は 31 で、AUTO_INCREMENT シリーズで次に利用可能な値は 35 。そして col の挿入値はその時点から始まり、その結果が SELECT クエリの表示になる。

ここで重要なことは、1 つのテーブルにこれら 2 つの変数をした場合の効果を制限することはできないということである。ゆえに、別のデータベース管理システムで提供しているシーケンスとは併用できない。この変数は、MySQL サーバの すべて のテーブルにある AUTO_INCREMENT カラムのすべての動作を制御する。この変数のどちらかをグローバルでセットした場合、グローバル値を変更するか、またはローカルでこれらを設定して上書きするまで、あるいは mysqld が再起動するまで、その効果が続くことになる。ローカルで設定した場合、新しい値はすべてのテーブルの AUTO_INCREMENT カラムに影響し、そのセッションのユーザが新たな行を挿入することになる。つまり値がセッション中に変更することになる。

auto_increment_increment のデフォルト値は 1 。詳細は 項5.2.3.1. 「Auto-Increment in Multiple-Master Replication」 を参照のこと。

auto_increment_offset

この変数のデフォルト値は 1。auto_increment_increment での記述も参照のこと。

automatic_sp_privileges

この変数が 1 (デフォルト) の場合、サーバが自動的に EXECUTE および ALTER ROUTINE の権限をストアド ルーチンのクリエータに与える。(ALTER ROUTINE 権限で、ルーチンをドロップの対象にする。) つまりサーバが、クリエータのルーチンをドロップするときに、自動的にこの権限もドロップする。automatic_sp_privileges が 0 の場合、サーバは自動的にはドロップしない。権限もドロップの対象にはならない。

back_log

MySQL で保持できる未解決の接続要求数。これは、短時間にメインの MySQL スレッドに多くの接続要求が集中したときに機能する (役立つ)。そして、メイン スレッドが接続をチェックするため、新規スレッドの開始には時間（若干）がかかる。つまり back_log 値は、MySQL が一時的に新規要求への回答を停止するまでの瞬時に、スタック可能な要求の数を示す。短時間に多くの接続要求数がある場合にだけ、この値を大きくする。

つまり、この値は、TCP/IP 接続のリッスン キューのサイズである。使用しているオペレーティング システムそのものにも、このキュー サイズの制限がある。詳細については、Unix listen() システムコールのマニュアルページを参照のこと。この変数の最大値については、OS のドキュメントを参照する。back_log を、オペレーティングシステムの制限値より大きくしても、効果はない。

basedir

基準パスを指定する。MySQL をインストールしたディレクトリを指す。--basedir オプションで起動時に設定できる。

binlog_cache_size

トランザクション中にバイナリ ログに対する SQL ステートメントを保持するキャッシュのサイズ。(トランザクション間でメモリに保持する SQL文の最大数。) サーバがトランザクションのストレージ エンジンをサポートする場合、あるいはサーバで --log-bin オプションを使用して、バイナリ ログを可能にしている場合、バイナリ ログ キャッシュをクライアントに割り当てる。大きな複数ステートメントのトランザクションが頻繁にある場合、この値を大きくすると、パフォーマンスを向上できる。Binlog_cache_use と Binlog_cache_disk_use のステータス変数はこの変数のサイズ調整に便利である。詳細は 項4.11.4. 「バイナリ ログ」 を参照のこと。

binlog_format

バイナリ ロギング形式。STATEMENT、ROW、MIXED のどれかになる。binlog_format は 起動時に --binlog-format オプションで設定する。または、ランタイムで binlog_format 変数でも設定できるが、グローバル スコープでこの変数を設定するには、SUPER 権限が必要になる (項5.1.2. 「レプリケーション フォーマット」 を参照のこと)。(スタートアップ変数の導入：MySQL 5.1.5、ランタイム変数の導入：MySQL 5.1.8、MIXED の導入：MySQL 5.1.8)

デフォルトでは STATEMENT を使用。MIXED を指定して、ステートメント ベースのレプリケーションにすることもできる。ただし、行ベースのレプリケーションで正確な結果を保証する場合 (その必要がある場合)、たとえば、ユーザ定義関数 (UDF)、または UUID() 関数を含むステートメントの場合には、この限りではない (別の事情がある)。格納ルーチン (stored functions) やトリガなどに、MIXED を指定して、ステートメント ベースのレプリケーションを行う場合も例外である。

ランタイムでレプリケーションの仕方を切り替えることができない場合

この 3 つのどれかに該当する場合に、レプリケーションの仕方を変更すると、エラーになる。

MySQL 5.1.8 前は、行ベース レプリケーションの仕方を変更することは --log-bin-trust-function-creators=1 および --innodb_locks_unsafe_for_binlog を明示的に設定するとしていた。しかし、MySQL 5.1.8 以降 (MySQL 5.1.8 を含む) は、行ベースのレプリケーションにこのオプションで明示設定しても、通用しない。

bulk_insert_buffer_size

空白ではないテーブルにデータを追加する場合に、MyISAM は特殊なツリー状のキャッシュを使用して、バルクの INSERT ... SELECT、INSERT ... VALUES (...), (...), ...、LOAD DATA INFILEを高速化する。この変数で、スレッドごとのキャッシュ ツリーのサイズを制限する（バイト単位）。この値を 0 に設定すると、最適化は無効になる。デフォルト値は 8 MB 。

character_set_client

クライアント送信の文字列のキャラクタ セット (クライアントが送信するキャラクタ セット)。

character_set_connection

キャラクタ セット情報がないリテラルの並びで、数値→文字と変換するときのキャラクタ セット。

character_set_database

デフォルト データベースで使用するキャラクタ セット。デフォルト データベースが変化する度に、サーバがこの変数を変更する。デフォルト データベースが存在しない場合、この値は character_set_server と同一。

character_set_filesystem

ファイルシステムのキャラクタ セット。LOAD DATA INFILE や SELECT ... INTO OUTFILE などのステートメントや LOAD_FILE() 関数に対して、この変数でファイル名とリテラルの文字列を読み取る。ファイルを開けようとすると、ファイル名が character_set_client から character_set_filesystem に変わる。デフォルト値は binary (変換が起こらない) である。マルチ バイトのファイル名を利用できるシステムでは、異なる値を使用することが好ましい。たとえば、UTF-8 でファイル名を表示しているシステムの場合は、character_set_filesytem を 'utf8' にセットする。(MySQL 5.1.6 実装)

character_set_results

クライアントへ返す文字列 (クエリ結果) のキャラクタ セット。

character_set_server

サーバのデフォルトのキャラクタ セット。

character_set_system

識別子の書き出しにサーバが使用するキャラクタ セット。この値は常に utf8。

character_sets_dir

キャラクタ セットを格納しているディレクトリ。

collation_connection

接続キャラクタ セットの照合順序。

collation_database

デフォルト データベースの照合順序。デフォルト データベースが変化する度に、サーバがこの変数を変更する。デフォルトデータベースが存在しない場合、この値は collation_server と同一。

collation_server

サーバのデフォルトの照合順序

completion_type

トランザクションのコンプリーション タイプ

concurrent_insert

ON (デフォルト) の場合、INSERT および SELECT ステートメントを MyISAM テーブルで同時に実行できる (間にフリー ブロックがない場合)。このオプションを使用しないように設定するには、mysqld を --safe または --skip-new で起動する。

この変数では次の整数値を使う。

項6.3.3. 「同時挿入」 を参照のこと。

connect_timeout

mysqld サーバが、Bad handshake を返すまで、接続パケットを待つ秒数

datadir

MySQL をインストールしたディレクトリ。この変数は --basedir オプションで設定できる。

date_format

この変数は実装していない。

datetime_format

この変数は実装していない。

default_week_format

デフォルト モード値。WEEK() 関数に使う。詳細は 項11.5. 「日付時刻関数」 を参照のこと。

delay_key_write

MyISAM テーブルにだけ使えるオプション。この値は、CREATE TABLE ステートメントに使用するときに、DELAY_KEY_WRITE テーブル オプションの処理に影響する。次の表で値の詳細を参照のこと。

DELAY_KEY_WRITE をテーブルに対して可能にした場合、インデックス更新でキー バッファのフラッシュではなく、テーブルが閉じたときにだけフラッシュする。これを利用すると、キーの書き込みスピードを速めることが可能である。ただし、これを使用する場合には、--myisam-recover オプションでサーバを立ち上げて、すべての MyISAM テーブルの自動チェックを設定しておく必要がある (例： --myisam-recover=BACKUP,FORCE)。詳細は 項4.2.2. 「コマンド オプション」 および 項13.4.1. 「MyISAM スタートアップオプション」 を参照のこと。

ノート： --external-locking で外部ロックを有効化した場合、遅延キー書き込み (delayed key write) があるテーブルのインデックス破損に対するプロテクションがなくなる。

delayed_insert_limit

delayed_insert_limit レコードを挿入後、INSERT DELAYED ハンドラは、保留中の SELECT ステートメントがあるかどうかチェックする。ステートメントがある場合、ハンドラは処理を続行する前に保留中のステートメントの実行を許可する。

delayed_insert_timeout

INSERT DELAYED ハンドラ スレッドが INSERT ステートメントを待機する時間。

delayed_queue_size

INSERT DELAYED を処理時のテーブルあたりのキューの最大値（レコード単位）。キューが最大値に達すると、INSERT DELAYED を実行するすべてのクライアントは、キューに空きができるまで待機する。

div_precision_increment

この変数は、小数点以下の桁数を示す。DIV演算子(/) での演算結果を高める。デフォルト値は 4 。最小値は 0 、最大値は 30。次の例はデフォルト値を高めた場合の効果を示す。

mysql> SELECT 1/7;
+--------+
| 1/7    |
+--------+
| 0.1429 |
+--------+
mysql> SET div_precision_increment = 12;
mysql> SELECT 1/7;
+----------------+
| 1/7            |
+----------------+
| 0.142857142857 |
+----------------+

event_scheduler

この変数は Event Scheduler (イベント スケジューラ) のステータス (状態) を示す。MySQL 5.1.12 から予定している値は、ON、OFF 、DISABLED。OFF をデフォルトとする。Event Scheduler 操作における、この変数とその効果は、 リンク (Events 関連の概略) を参照のこと。

(MySQL 5.1.6 での追加)

engine_condition_pushdown

この変数は、NDB に適用する。デフォルトでは 0 (OFF)。SELECT * FROM t WHERE mycol = 42 のように mycol でインデックス化してないカラムのクエリを実行する場合、そのクエリは NDB ノード毎にフル テーブル スキャンの対象になる。それぞれのノードで SQL サーバにすべての行 (レコード) を送り、 WHERE 条件なる。engine_condition_pushdown を 1 (ON) にセットすると、条件はストレージ エンジンまで 「押し下げられ」、NDB ノードにまで届く。それぞれのノードでスキャンを行う条件を持っているため、MySQL サーバにその条件に適合する行を送り返す。

expire_logs_days

バイナリ ログの自動削除の日数を指定する。 デフォルトは 0 で 「自動削除しない」 ことを意味する。MySQLサーバ起動時もしくは ログをローテートするときが、ログを削除するタイミングである。

flush

ON の場合、SQL ステートメントの後で、サーバがすべての変更をデスクにフラッシュ (同期) する。通常、MySQL は、SQL ステートメントで、すべての変更をデスクに書き込むことはなく、オペレーティング システムにディスクとの同期を任せる。項B.1.4.2. 「What to Do If MySQL Keeps Crashing」 を参照のこと。--flush オプションで mysqld を立ち上げる場合には、この変数を ON に設定する。

flush_time

これを 0 以外の値に設定する場合、リソースの解放と未フラッシュ データのディスクへ同期するために、flush_time 秒ごとにすべてのテーブルを閉じる。Windows 9x、Me など別リソースに限りがあるシステムの場合にだけ、このオプションを使用する (推奨)。

ft_boolean_syntax

IN BOOLEAN MODE を使用しているブーリアン全文検索をサポートする演算子一覧。詳細は 項11.7.1. 「ブール全文検索」 を参照のこと。

デフォルトの変数値は '+?-><()~*:""&|' である。この値を変更するときのルールは次の通り。

ft_max_word_len

FULLTEXT インデックスの単語 (word) の最大文字数

ノート:FULLTEXT インデックスは、変数を変更すると、再ビルドしなければならない。REPAIR TABLE tbl_name QUICK を使用のこと。

ft_min_word_len

FULLTEXT インデックスの単語の最小文字数

ノート:FULLTEXT インデックスは、変数を変更すると、再ビルドしなければならない。REPAIR TABLE tbl_name QUICK を使用のこと。

ft_query_expansion_limit

WITH QUERY EXPANSION を使用した全文検索の最上位マッチ数。

ft_stopword_file

全文検索のストップワード リストのファイル。ファイル内のすべてのストップワードが使用対象になるが、コメントは使用しない。デフォルトは、ストップワードの組み込みリストを使用する ( storage/myisam/ft_static.c ファイルの定義)。このパラメータを空白の文字列（''）に設定すると、ストップワードのフィルタリングを無効化する。

ノート:変数またはストップワードの内容を変更すると、FULLTEXT インデックスを再ビルドしなければならない。REPAIR TABLE tbl_name QUICK を使用のこと。

general_log

一般クエリ ログを有効化しているかどうかを示す。値が 0 (または OFF) の場合、ログしない。値が 1 (または ON) の場合、ログする。デフォルトは --log オプションを設定しているかどうかによる。ログ出力先は log_output システム変数で制御する。値を NONE にした場合、ログできるようにしていても、エントリを書き込まない。(general_log は MySQL 5.1.12 での導入)

general_log_file

一般クエリ ログ ファイルの名前。デフォルトは host_name.log 。初期値は --log オプションで変更可能。(MySQL 5.1.12 から導入)

group_concat_max_len

GROUP_CONCAT() 関数の最大許容結果長さ (返却値の最大文字数) デフォルトは 1024 。

have_archive

YES： mysqld で ARCHIVE テーブルをサポートする場合。NO： そうでない場合。

have_blackhole_engine

YES ： mysqld で BLACKHOLE テーブルをサポートしている場合。 NO ：そうでない場合。

have_compress

YES ： zlib 圧縮ライブラリをサーバで利用できる場合。NO ：そうでない場合 (このときは、COMPRESS() および UNCOMPRESS() 関数は使用できない)。

have_crypt

YES ： crypt() システム コールをサーバで利用きる場合。NO ：そうでない場合 (このときは、ENCRYPT() 関数は使用できない)。

have_csv

YES ： mysqld で ARCHIVE テーブルをサポートする場合。 NO ：そうでない場合。

have_dynamic_loading

YES ： mysqld で動的ロードのプラグインをサポートする場合。 NO ：そうでない場合。(MySQL 5.1.10 から導入)

have_example_engine

YES ： mysqld で EXAMPLE テーブルをサポートしている場合。 NO ：そうでない場合。

have_federated_engine

YES ： mysqld で FEDERATED テーブルをサポートする場合。 NO ：そうでない場合。

have_geometry

YES ：サーバで空間データ型 (spatial) をサポートしている場合。NO そうでない場合

have_innodb

YES ： mysqld で InnoDB テーブルをサポートしている場合。DISABLED ： --skip-innodb を使用している場合。

have_ndbcluster

YES ： mysqld で NDB Cluster テーブルをサポートしている場合。DISABLED ： --skip-ndbcluster を使用している場合。

have_partitioning

YES ： mysqld でパーティショニング (領域確保) をサポートしている場合。(MySQL 5.1.1 から導入。MySQL 5.1.6 では、have_partition_engine から have_partioning になった (改名)。

have_openssl

YES ： mysqld で SSL 接続をサポートする場合。 NO ：そうでない場合。

have_query_cache

YES ： mysqld で クエリ キャッシュをサポートする場合。 NO ：そうでない場合。

have_row_based_replication

YES ：サーバで行ベースのバイナリ ロギングのレプリケーションを実行できる場合。NO ： サーバでステートメント ベースのロギングを行う。詳細は 項5.1.2. 「レプリケーション フォーマット」 を参照のこと。(MySQL 5.1.5 から導入したが、MySQL 5.1.15 で削除している。)

have_rtree_keys

YES ： RTREE インデックスを利用できる場合。NO ：そうでない場合。(MyISAM テーブルの空間インデックスで使用している。)

have_symlink

YES ： シンボリック リンク サポートを有効化している場合。NO ： そうでない場合。Unix では DATA DIRECTORY および INDEX DIRECTORY のテーブル オプションを必要とする。Windows では、データ ディレクトリの symlink 関数を必要とする。

init_connect

クライアント接続でサーバが実行する文字列。この文字列は １ つ以上の SQL ステートメントから成る。複数のステートメントを指定するには、セミコロンで文字を区切る。たとえば、クライアントで自動コミット (autocommit) モードを有効にしていた場合に、クライアントでデフォルトとして開始する。自動コミットをデフォルトで無効にするグローバル変数は存在しないが、init_connect を使用すると、同様の効果を期待できる (複数のステートメントを指定する)。

SET GLOBAL init_connect='SET AUTOCOMMIT=0';

これの変数は、コマンドラインまたはオプション ファイルで設定できる。オプション ファイルで変数を設定するには、次のラインを使用する。

[mysqld]
init_connect='SET AUTOCOMMIT=0'

ノート： init_connect の内容は SUPER 権限のあるユーザには通用しない。つまり、init_connect の誤値がクライアント接続を阻止しないようにしている。たとえば、シンタックス エラーを保持する値がステートメントにあると、クライアント接続に支障をきたす。SUPER 権限を持つユーザに対して init_connect を実行しないということは、ユーザとの接続と init_connect の値に対して害を与えないということである。

init_file

サーバ起動時に、--init-file オプションで指定するファイルの名前。このファイルに起動時に実行する (したい) SQL ステートメントを組み込む。それぞれのステートメントを一行命令文として、コメントは入れないこと。

ノート： --init-file オプションは、MySQL を --disable-grant-options オプションでコンフィギャしている場合には利用不可。詳細は 項2.9.2. 「典型的な configure オプション」 を参照のこと。

init_slave

init_connect に類似する。SQL スレッドを開始するときにスレーブ サーバが実行する文字列。.この文字列の形式は init_connect と同一である。

innodb_xxx

InnoDB システム変数は 項13.5.4. 「InnoDB 起動オプションとシステム変数」 を参照のこと。

interactive_timeout

対話式接続を終了する前に、サーバがアクティビティを待機する秒数。対話型クライアントの定義は、mysql_real_connect() で CLIENT_INTERACTIVE オプションを使用するクライアントのことである。wait_timeout も参照のこと。

join_buffer_size

完全結合（インデックスを使用しない結合）に使用するバッファのサイズ。これにより、フル テーブル スキャンを実行できる。一般的には、結合を高速化する最良の方法は、インデックスを追加することである。しかし、インデックスを追加できない場合に、 join_buffer_size の値を大きくすると結合が速くなる (完全結合になる)。つまり、2 つのテーブル間の完全結合ごとにバッファを割り当てる。テーブル間の結合が複雑な場合は、複合バッファを必要とすることもある。

key_buffer_size

MyISAM テーブルのインデックス ブロックをバッファし、すべてのスレッドで共有。key_buffer_size は、インデックス ブロックに使用するバッファのサイズである。キー バッファはキー キャッシュのこと。

key_buffer_size の最大値は 4 GB 。物理 RAM、ＲＡＭ 制限、オペレーティング システム、プラットフォームの状態などによるが、効果的な設定値としては、4 GB を下回る程度が良い。

環境に応じて、インデックス処理 (すべての読み込みと複数の書き込み) を改善する目的で、この値を大きくできる。一般的には、マシンのメモリ使用率 25 % の値であることが好ましい。使用率の 50 % にすると、値が大き過ぎるため、システム処理が極端に遅くなる。MySQL のデータ読み込みのファイルシステムのキャッシュは OS に依存しているため、ファイル キャッシュ用にスペースに余裕を持たせることが必要である。別のストレージ エンジンの必要メモリに関しても検討のこと。

同時書き込みが多い場合などに、スピードを上げるには、LOCK TABLES を使用する。詳細は 項6.2.16. 「INSERTステートメントの速度」 を参照のこと。

キー バッファのパフォーマンスをチェックするには、SHOW STATUS ステートメントを発行し、Key_read_requests、Key_reads、Key_write_requests、そして Key_writes の変数を調べる (項12.5.4. 「SHOW 構文」 を参照)。一般的には Key_reads/Key_read_requests の比率は、0.01 より小さいことが望ましい。操作がほとんど更新と削除だけの場合は Key_writes/Key_write_requests の比率は 1 に近い。同時に多くの行に影響を与える更新を行う場合や、DELAY_KEY_WRITE テーブル オプションを使用している場合には、より小さい比率になる。

使用中のキー バッファのフラクション (破片) は、バッファ ブロック サイズと、key_buffer_size に Key_blocks_unused を併用して決めることができる。これは、key_cache_block_size システム変数から利用可能。

1 - ((Key_blocks_unused × key_cache_block_size) / key_buffer_size)

これは近似値である。キー バッファのスペースによっては、管理ストラクチャに対して内部的に割り当てを行っているので、近似とする。

MyISAM の複数キー キャッシュを作成することが可能である。サイズの上限は、4 GB で、グループごとではなく、キャッシュごとに適用する。詳細は 項6.4.6. 「MyISAMキーキャッシュ」 を参照のこと。

key_cache_age_threshold

この値は、キー キャッシュの hot サブ チェーンから warm サブ チェーンへのバッファ降格を制御する。この値が小さいと降格は急激に起こる。最小値は 100。デフォルトは 300。詳細は 項6.4.6. 「MyISAMキーキャッシュ」 を参照。

key_cache_block_size

キー キャッシュのブロック サイズをバイト単位 (byte)。 デフォルトは 1024 。詳細は 項6.4.6. 「MyISAMキーキャッシュ」 を参照のこと。.

key_cache_division_limit

キー キャッシュのバッファ チェーンにおける hot と warm のサブ チェーン間のディビジョン ポイント (分岐点)。 この値は、warm のサブ チェーンに使用するバッファ チェーンのパーセンテージである。許容範囲は 1 から 100 まで。デフォルトは 100 。詳細は 項6.4.6. 「MyISAMキーキャッシュ」 を参照のこと。

language

エラー メッセージに使用する言語。

large_file_support

mysqld を大きなファイルをサポートするオプションでコンパイルしているかどうか (を指す)。

large_pages

大きなページをサポートしている場合の戻値。

lc_time_names

ロケールを指定する。これは月日、略語などを表示する言語を制御する。DATE_FORMAT()、DAYNAME()、MONTHNAME() などの関数からの出力に影響する。ローケル名は POSIX 標準で、'ja_JP' または 'pt_BR' などとする。デフォルトはシステムのローケル設定を問わず、'en_US' である。詳細は 項4.10.9. 「MySQL サーバのローケル サポート」 を参照のこと。(MySQL 5.1.12 で導入)

license

サーバのライセンス タイプ (種類)

local_infile

LOAD DATA INFILE ステートメントで、LOCAL をサポートしているかどうか (を指す)。詳細は 項4.6.4. 「LOAD DATA LOCAL のセキュリティ関連事項」を参照のこと。

locked_in_memory

--memlock によるメモリのロックが mysqld で有効かどうか (を指す)。

log

すべてのクエリのログを有効にしているかどうか (を指す)。項4.11.3. 「一般クエリ ログ」 を参照のこと。

log_bin

バイナリ ログを有効にしているかどうか (を指す)。 項4.11.4. 「バイナリ ログ」 を参照のこと。

log_bin_trust_function_creators

この値はバイナリ ログを有効化しているときに適用。Stored Function (関数) を作成するユーザが、 信用できない関数を作成する可能性を制御する。つまり、バイナリ ログへの書き込みに対して危険な関数を発行しないようにする。 この値を 0 (デフォルト) にする場合、CREATE ROUTINE、ALTER ROUTINE 権限のいずれかに加え、SUPER 権限を持たないユーザによる関数の作成 (置換) を許可しない。 0 にすると、その制限が強まり、DETERMINISTIC あるいは、READS SQL DATA、NO SQL のいずれかの特性を持った関数での宣言が必要になる。この値を 1 にすると、MySQL は関数に対して、このような制限はなくなる。詳細は 項17.4. 「ストアドルーチンとトリガのバイナリログ」 を参照のこと。

log_error

エラー ログの位置。

log_output

一般クエリ ログとスロー クエリ ログの出力先。TABLE (テーブルへのログ)、FILE (ファイルへのログ)、NONE (テーブルまたはファイルにログしない。) などを、複数の単語をカンマ区切りリストにできる。デフォルトは TABLE。NONE は、どの指定子よりも優先となる。つまり、NONE の場合、ログ エントリはログを有効化していても書き込みがない。ログを有効にしていなければ、log_output が NONE でなくても、ログできない。詳細は 項4.11.1. 「一般クエリとスロー クエリのログ出力先の選択」 を参照のこと。(MySQL 5.1.6 から導入)

log_queries_not_using_indexes

インデックスしていないクエリをスロー クエリ ログに記録しているかどうか (を指す)。詳細は 項4.11.5. 「スロー クエリ ログ」 を参照のこと。(MySQL 5.1.11 から導入)

log_slave_updates

スレーブ サーバがマスタ サーバから受け取った更新を、スレーブ サーバ自身のバイナリ ログに記録するかどうかを指す。この効果を得る (スレーブでバイナリ ログする) には、スレーブ上でバイナリ ログを有効にしておく必要がある。項5.1.3. 「レプリケーションのオプションと変数」 を参照のこと。

log_slow_queries

スロー クエリのログするかどうか (を指す)。「Slow」 は long_query_time の値で決定する。項4.11.5. 「スロー クエリ ログ」 を参照のこと。

log_warnings

警告メッセージに追加情報を表示するかどうか (を指す)。デフォルトでは有効 (1) 。0 にすると無効になる。この値が1より小さい場合、接続を中断した情報をエラーログに出力できない。

long_query_time

クエリでこの値（秒単位）より時間がかかると、Slow_queries カウンタが増える (increment)。--log-slow-queries オプションを使用している場合、クエリはスロー クエリ ログ ファイルでの記録になる。この値は、CPU 時間ではなく、リアル タイムである。したがって、低負荷のシステムではしきい値 (基準値) より下のクエリが、高負荷のシステムでしきい値より上になる場合がある。下限値は 1 で、デフォルトは 10。項4.11.5. 「スロー クエリ ログ」 を参照のこと。

low_priority_updates

1 に設定すると、対象テーブルに影響する SELECT または LOCK TABLE READ を完了するまで、INSERT、UPDATE、DELETE、LOCK TABLE WRITE などのステートメントを待機させる。この変数の旧称は sql_low_priority_updates 。

lower_case_file_system

データ ディレクトリのファイルシステムの大小文字区別を示す。OFF の場合は、ファイル名でこの区別をしていることを意味し、ON の場合は大小文字の区別をしていないことを意味する。

lower_case_table_names

この値が 1 の場合、テーブル名を小文字変換で格納している。つまりテーブル名には大小文字の区別がないことを示す。この値が 2 の場合、テーブル名を入力通りに格納するが、小文字の区別をする。このオプションはデータベース名とテーブルのエイリアスで適用。項8.2.2. 「識別子の大文字/小文字区別」 を参照のこと。

InnoDB テーブルを使用する場合、名前を強制的に小文字に変換するには、すべてのプラットフォームでこの値を １ に設定する。

たとえば、Windows または Mac OS などで、システムで MySQL を実行していて、ファイル名に大小文字の区別がない場合は、この値を 0 に しない こと。起動時などでこの値をまだ設定していない状態で、かつデータ ディレクトリのファイルシステムで大小文字の区別をしていないときには、MySQL が自動的に lower_case_table_names を 2 に設定する。

max_allowed_packet

1 パケットの最大サイズ。または生成/中間文字列。

パケット メッセージ バッファは net_buffer_length バイトで初期化するが、必要に応じて max_allowed_packet バイトまで大きくできる。デフォルト値は小さいが、大きな（不正）パケットを受けないように設定している。

大きな BLOB カラムを使用している場合には、この値を大きくする必要がある。使用する最大の BLOB と同じ大きさにする。max_allowed_packet のプロトコル制限は 1GB。

max_binlog_cache_size

複数ステートメントのトランザクションでこれより多くのメモリが必要になると、Multi-statement transaction required more than 'max_binlog_cache_size' bytes of storage というエラーが発生する。下限値は 4096 で、最大 (デフォルト) は 4 GB 。

max_binlog_size

バイナリ ログ ファイルへの書き込みがログ ファイル サイズと干渉し、この値を超える場合、バイナリ ログをローテートする。(現行 ファイルを閉じて、次のファイルを開ける。) 設定可能値は、4096 バイト以上 1 GB (デフォルト) 以下。

注意 ： トランザクションではバイナリ ログへの書き込みを 1 つのまとまりとして処理するため、トランザクション自体を複数のバイナリ ログに分割することは絶対的にない。したがって、大きなトランザクションがある場合、バイナリログの max_binlog_size が大きくなることがある。

max_relay_log_size が 0 の場合、max_binlog_size の値がリレー ログにも適用となる。

max_connect_errors

ホストからの接続中断回数がこの値を越えた場合、それ以降、そのホストからの接続をブロックする。ブロックを解除するには、FLUSH HOSTS コマンドを使用する。

max_connections

MySQL への最大同時接続数。MySQL 5.1.15 以降のデフォルトは150 (以前は 100)。詳細は 項B.1.2.6. 「Too many connections」 を参照のこと。

MySQL Enterprise 警告：同時最大接続数を増加することには危険が伴います。MySQL Network Monitoring and Advisory Service では、max_connections に関するアドバイスを提供しています。詳細は http://www-jp.mysql.com/products/enterprise/advisors.html () で参照してください。

この値を増やすと、mysqld のファイルの記述子の数を増やすこととなる。ファイル記述子の制限に関するコメントは 項6.4.8. 「MySQL でのテーブルのオープンとクローズの方法」 を参照のこと。

max_delayed_threads

INSERT DELAYED ステートメント処理に、スレッドがこの数に達すると処理しない。つまり、スレッドの最大数である。使用中の INSERT DELAYED スレッド後に、データを新規テーブルに挿入すると、その行は DELAYED 属性を指定していない行になる。値を 0 に設定すると、MySQL は DELAYED を処理するスレッドを 作成しなくなる。事実上、DELAYED を完全に無効にする。

max_error_count

SHOW ERRORS や SHOW WARNINGS で表示するエラーや警告の最大数。

max_heap_table_size

MEMORY 型テーブルの最大メモリ サイズを設定する(ヒープ)。この変数の値で MEMORY テーブルの MAX_ROWS 値を計算する。この変数の設定は、既存の MEMORY テーブルには影響しない。ただし、CREATE TABLE などのステートメントで再生成したり、 ALTER TABLE または TRUNCATE TABLE で変更した場合は影響する。

MySQL Enterprise MySQL Network Monitoring and Advisory Service では、max_heap_table_size の最適設定に関するアドバイス (推奨) を提供しています。詳細は http://www-jp.mysql.com/products/enterprise/advisors.html を参照してください。

max_insert_delayed_threads

max_delayed_threads に対するシノニム。

max_join_size

max_join_size の値でクエリを制限する。長い時間をかけて百万行を返すような WHERE なしの結合を作成するようなユーザをいる場合にこの変数を設定すると、サーバへの無駄な負荷を軽減させることができる。(max_join_size 値を超える行数のレコードを読み取ろうとするとエラーになる。) SELECT ステートメントで、レコードの組み合わせ調べ (単一テーブルまたは複数テーブルに対するステートメント) がこの値を超える場合 や、またはこの値を超えるディスクシークの実行を許可しない。 この値を設定すると、キーの使用が不適切で長時間かかるような SELECT ステートメントを捕捉できる。

この変数を DEFAULT 以外の値で設定すると、SQL_BIG_SELECTS の値が 0 にリセットになる。SQL_BIG_SELECTS 値を再び設定すると、max_join_size 変数は無視の対象になる。

クエリ結果がクエリ キャッシュにある場合は、結果のサイズ チェックすることはなく、これは結果がすでに計算済みで、それをクライアントに送信することがサーバの負荷にならないためである。

この変数の旧称は sql_max_join_size である。

max_length_for_sort_data

使用する filesort アルゴリズムを決定するインデックス値の最大サイズ。項6.2.12. 「ORDER BY最適化」 を参照のこと。.

max_prepared_stmt_count

サーバの Prepared ステートメントの合計数の最大値。この値で制限する。リクエスト応答を大量に発生させることで、サーバの応答機能の帯域を使い切るなど、いわゆる DoS攻撃 (denial-of-service attacks) を受ける可能性がある環境で使用する。デフォルト値は 16382。許容値は 0 から 100 万。この値が実行中の Prepared ステートメントの数より低い場合は、既存ステートメントが影響を受けることはなく、そのまま使用できるが、新規のステートメントに関しては、この制限値よりも現行数を低減するまで、準備できない。(MySQL 5.1.10 からの導入)

max_relay_log_size

レプリケーション スレーブがリレー ログに書き込みをすると、カレント ログ ファイル サイズがこの変数値を越える原因になり、スレーブはリレー ログをローテートする。 (現行ファイルを閉じ、次のファイルを開ける。) max_relay_log_size を 0 とした場合、サーバはバイナリ ログとリレー ログの両方に max_binlog_size を使用する。max_relay_log_size が 0 より大きい場合、リレー ログのサイズを抑制し、両ログに異なるサイズを持たせることが可能になる。max_relay_log_size は 4096 バイトから 1GB 以内で設定するか、または 0 に設定する。デフォルト値は 0 。項5.5.1. 「レプリケーション実装の詳細」 を参照のこと。

max_seeks_for_key

キーでレコード検索の最大回数を制限する。キー スキャンでテーブルからレコードを検索するときに、MySQL オプティマイザでキーの基数とは関係なく (無視して)、キー検索の回数をこの指定値までとする。項12.5.4.17. 「SHOW INDEX 構文」 を参照のこと。この値を低く（100 くらいに）設定すると、MySQL でののスキャンがテーブルではなくキーを優先するようになる。

max_sort_length

BLOB 値または TEXT 値をソートするときに使用するバイト数。各値の最初の max_sort_length バイトだけを使用し、残りは無視になる。

max_sp_recursion_depth

ストアド プロシージャが呼び出す回数。このオプションのデフォルト値は 0 で、ストアド プロシージャの再帰を完全に無効にする。

この変数はグローバル、かつセッションごとの設定が可能。

max_tmp_tables

1 つのクライアントが同時に開けたままにできるテンポラリ テーブルの最大数。(このオプションはまだ利用できない。)

max_user_connections

単一ユーザ (MySQL アカウント) が同時に接続できる最大数。値 0 は 「制限なし」 という意味。

この値はグローバル スコープとセッション スコープ (読み込みオンリー) の両方を持つ。 セッション値は通常グローバル値と同じ値。ただし、 セッション ユーザが 0 以外の MAX_USER_CONNECTIONS 値を持ってる場合には、このセッション値がアカウント制限にも反映する。

max_write_lock_count

この回数の書き込みロックをした後に、読み取りロックを許可する。(ロックが必要なほど大量のテーブル書き込みがある場合など)

multi_range_count

テーブル ハンドラへ一括送信できる最大許容範囲 (範囲選択時)。デフォルトは256。複数の値域をハンドラへ 1回で送れると、一定の選択において劇的なパフォーマンス向上になる。これは NDB Cluster のテーブル ハンドラで非常に有用で、値域要求をすべてのノードへ送るときに役に立つ。要求のバッチを一度に送ることは、通信コストを大幅節減に繋がる。

myisam_data_pointer_size

CREATE TABLE 時に、MAX_ROWS オプションを指定していないときの MyISAM テーブル内部のポインタ サイズを指定する。(テーブルの最大物理サイズの決定。) 変数は 2 以上 7 以下である必要がる。デフォルトでは 6。項B.1.2.11. 「The table is full」 を参照のこと。

myisam_max_extra_sort_file_size (廃止)

ノート:この変数は MySQL 5.1 ではサポートしていない。詳細は MySQL 5.0 Reference Manual を参照のこと。

myisam_max_sort_file_size

REPAIR TABLE、ALTER TABLE、LOAD DATA INFILEなどを使用して MyISAM インデックスを再生成するときに、MySQL が使用できるテンポラリ ファイルの最大サイズ。ファイル サイズがこれより大きい場合、インデックスはキー キャッシュでの作成になる（時間がかかる）。値の単位はバイト。

デフォルトでは 2GB 。MyISAM インデックス ファイルがこのサイズを越え、ディスク容量が要るようになるときには、この値を大きくするとパフォーマンス向上になる。

myisam_recover_options

--myisam-recover オプションの値。項4.2.2. 「コマンド オプション」 を参照のこと。

myisam_repair_threads

この値が 1 より大きい場合、Repair by sorting の修復プロセスでの MyISAM テーブル インデックスは並列での作成になる。インデックス毎のスレッド生成になる。

ノート:複数スレッドの修復は ベータ段階 です。

myisam_sort_buffer_size

REPAIR TABLE 文実行時に MyISAM テーブルのインデックスをソートする場合、または CREATE INDEX や ALTER TABLE などでインデックスを作成する場合に、割り当てるバッファのサイズ。

myisam_stats_method

MyISAM テーブルでインデックス分布統計を集計するとき、サーバの NULL 値の扱いを決定する。この変数の値は nulls_equal または nulls_unequal のどちらか。nulls_equal の場合、すべての NULL インデックス値を同等として扱い、 NULL 値の数とサイズが同等の単値のグループを生成する。nulls_unequal の場合、NULL の値同士を同等とは扱わず、それぞれの NULL で、サイズを 1 とする独特のグループを生成する。

この方法で、クエリの実行に対して、オプティマイザがインデックスを選択するときに影響を受けるテーブルの統計を取る。詳細は 項6.4.7. 「MyISAMインデックス統計コレクション」 を参照のこと。

myisam_use_mmap

MyISAM テーブルの読み書き込みで使用するメモリ マッピング。(MySQL 5.1.4 での追加)

multi_read_range

範囲指定の SELECT 文を発行するときに、ストレージ エンジンに送ることができる範囲の最大値を指定する。デフォルトでは 256。 複数の範囲指定をストレージ エンジンに送ることは 特定の SELECT 文に対して、特に NDBCLUSTER において、大幅にパフォーマンスを改善する。

named_pipe

サーバが名前付きパイプ (named pipes) を経由した接続をサポートするかどうか。Windows 専用。

ndb_autoincrement_prefetch_sz

auto_increment カラムにおけるギャップの確率 (probability) を決定する。1 にセットした場合、これを最小限に抑える。最適化を目的として値を大きくする設定すると、? が挿入を高速化するが、バッチ挿入に使用する自動インクリメントの数が減る可能性がある。デフォルトは 32。下限値は 1.

ndb_cache_check_time

NDB のクエリ キャッシュをチェックする前に待機するミリ秒 (msec)。この値を 0 (デフォルト) に設定すると、NDB クエリ キャッシュでクエリ毎のバリデーションを行う。

推奨最大値は 1000 で、クエリ キャッシュが一秒間に一度のチェック対象になることを意味する。値が大きくなるということは、NDB のクエリ キャッシュのチェック回数が減り、別のmysqld での更新が原因で、バリデーションが無効化することを意味する。この値を 2000 以上に設定しないこと。

ndb_extra_logging

デバッグやトラブルシューティング用に追加の NDB ロギングを行うには、ゼロではない値を設定する。デフォルトは 0。

(MySQL 5.1.6 での追加)

ndb_force_send

NDB へ迅速にバッファを送るよう命令する。他のスレッドを待機しない。デフォルトは ON 。

ndb_index_stat_cache_entries

統計の精度を設定する。開始キーと終了キーの数を決め、統計メモリ キャッシュに格納する。ゼロはキャッシュしていないことを示し、その場合には、データ ノードが直接的にクエリになる。デフォルトは 32.

ndb_index_stat_enable

NDBインデックス統計。クエリの最適化。デフォルトでは ON。

ndb_index_stat_update_freq

統計キャッシュの代わりにデータ ノードにクエリを行うかを示す回数。たとえば、値が 20 の場合、クエリ 20 毎に、データ ノードを渡すという意味。

ndb_report_thresh_binlog_epoch_slip

binlog ステータスをレポートするまでに、遅れるエポック数の閾値。たとえば、値が 3 (デフォルト) であった場合、ストレージ ノードから受けたエポックと 3 以上の binlog に適用したエポックの数が異なるときに、ステータス メッセージをクラスタ ログする。

ndb_report_thresh_binlog_mem_usage

binlog ステータスをレポートするまで残っている空きメモリのパーセンテージの閾値。たとえば、値が 10 (デフォルト) であった場合、データ ノードから受ける binlog データに使うメモリが 10% 降下するという意味。そしてステータス メッセージをクラスタ ログにする。

ndb_use_copying_alter_table

NDB で、オンラインの ALTER TABLE 操作で、問題が発生したテーブルをコピーするために使用する。デフォルトは OFF になっている。

(MySQL 5.1.12 での追加)

ndb_use_exact_count

SELECT COUNT(*) クエリの高速化を図るときに、レコードの回数を適用するよう NDB に命令する。デフォルトでは ON になっている。全体的にクエリを速度化するには、これを無効にする。つまり、ndb_use_exact_count を OFF にする。

ndb_use_transactions

NDB トランザクションを OFF に設定することで無効にできるが、これは極力やらない。デフォルトでは ON になっている。

net_buffer_length

クライアント スレッドが接続バッファと結果バッファに関連付けられている。両者は net_buffer_length で与えられたサイズで始まるが、必要に応じて、max_allowed_packet バイトまで劇的に拡大できる。結果バッファは SQL 文毎に net_buffer_length まで縮小する。

この値はできるだけ変更しない。ただし、メモリが非常に限られている環境において、この値をクライアントから送信されるステートメントの長さに合わせて設定できる。ステートメントがこの長さを越えた場合、接続バッファは自動的に拡大する。net_buffer_length の最大値は 1MB に設定できる。

net_read_timeout

読み込みを中断するまでデータ追加を待機する秒数。タイムアウトは TCP/IP 接続にだけ適用する。これは Unix のソケット ファイル、または名前付きパイプ、共有メモリなどを経由していない接続のことである。サーバがクライアントからの読み込みを行うとき、net_read_timeout のタイムアウト値が中断するタイミングを制御する。書き込みを行うときは、net_write_timeout のタイムアウト値が中断するタイミングを制御する。slave_net_timeout のセクションも参照のこと。

net_retry_count

通信ポートでの読み込みが中断した場合に、実行できる再試行回数。FreeBSD でこの値を大きくすると、内部中断をすべてのスレッドに通知する。

net_write_timeout

書き込みを中断するまで、ブロック書き込みを待機する秒数。タイムアウトは TCP/IP 接続にだけ適用する。これは Unix のソケット ファイル、または名前付きパイプ、共有メモリなどを経由していない接続のことである。net_read_timeout も参照のこと。

new

MySQL 4.0 において、MySQL 4.1と同様の動作 (下位互換性)をするかどうか (を指す)。MySQL 5.1 では、この値は常に OFF。

old_passwords

サーバが MySQL 4.1より前で使用しているパスワード形式を採用するかどうか (を指す)。項B.1.2.3. 「Client does not support authentication protocol」 を参照のこと。

one_shot

これは変数ではない。しかし、特定の変数を設定するときに使用できる。詳細は 項12.5.3. 「SET 構文」 を参照のこと。

open_files_limit

mysqld が開けるオペレーティング システムのファイル数。これはシステムで指定されている実際の値であり、起動時のパラメータとして --open-files-limit オプションで mysqld または mysqld_safe に指定したものとは異なる場合がある。MySQL がオープンファイル数を変更できないシステムでは 0 になる。

optimizer_prune_level

ヒューリスティックス (経験則) を採用したクエリ最適化を制御し、オプティマイザの検索スペースからあまり見込みのない、部分的なプランをパージ (削除) する。値を 0 にすると、ヒューリスティックスを無効化し、オプティマイザは完全な検索を行う。値を 1 にすると、オプティマイザは中間プラン (intermediate plans) で検索したレコード数に基づいてプランを削除する。

optimizer_search_depth

クエリ オプティマイザが実行する検索深さの最大値を指定する。クエリ結果の関係数が大きい値の場合は、プランよりも良いということを示すが、クエリの実行プラン生成に時間がかかる。関係数が小さい値の場合は、より速い実行プランを返すが、結果プランが最適であるとは言えない。値を 0 した場合、システムは自動的に妥当な値を計算する。値をクエリに使用しているテーブルの最大値に + 2 した場合は、オプティマイザが検索を実行するときに、MySQL 5.0.0 (と前バージョン) で使用したアルゴリズムに切り替える。

pid_file

プロセス ID (PID) ファイルのパス。--pid-file オプションで設定する。

plugin_dir

プラグイン ディレクトリのパス。(MySQL 5.1.2 での追加)

port

mysqldサーバが利用するTCP/IPポート番号。--port オプションで設定する。

preload_buffer_size

インデックスをプレロードするときに割り当てるバッファ サイズ。

prepared_stmt_count

準備されたステートメント (prepared statements) の現在値。max_prepared_stmt_count システム変数で与えるステートメントの最大値。MySQL 5.1.10 からの追加で、MySQL 5.1.14 では、 Prepared_stmt_count グローバル ステータス変数に変換していた。

protocol_version

MySQL サーバが使うクライアント/サーバ間のプロトコル バージョン。

query_alloc_block_size

クエリの解析や実行で生成するオブジェクトに割り当てるメモリ ブロックの割り当てサイズ。メモリのフラグメントに問題がある場合、これを少し大きくすると改善できる可能性がある。

query_cache_limit

この値より大きい結果はキャッシュしない。デフォルトは 1MB。

query_cache_min_res_unit

クエリ キャッシュで割り当てるブロックの最小サイズ (バイト単位)。デフォルトは 4096(4KB)。この変数を利用した効果については、項4.13.3. 「クエリ キャッシュの設定」 を参照のこと。

query_cache_size

古いクエリの結果の保存用に割り当てたメモリ (クエリ キャッシュで確保するメモリ)。 この値を 0 （デフォルト） にすると、クエリ キャッシュは無効化する。許容値は 1024 の倍数。値はすべて、近似の倍数で端数を切り捨てる。ノート： query_cache_size バイトのメモリは、query_cache_type が 0 で設定してあっても、割り当ての対象となる。詳細は 項4.13.3. 「クエリ キャッシュの設定」 を参照のこと。

query_cache_type

クエリ キャッシュを行う条件を指定する。GLOBAL 値に設定すると、これ以降に接続するすべてのクライアントの条件が反映する。それぞれのクライアントで SESSION 値を設定することができ、これはマシン レベルでのクエリ キャッシュに影響する。次のテーブルは数値を示す。

この変数のデフォルトは ON。

query_cache_wlock_invalidate

通常、クライアントが MyISAM テーブルの WRITE ロックを獲得する場合、別のクライアントはクエリの結果がキャッシュ内にあるときは、そのテーブルへのクエリ発行をブロックしない。この値を 1 にした場合、テーブルに対する WRITE ロックを得ることとなり、そのテーブルに対するクエリ キャッシュのクエリは無効化する。これにより、テーブルへのアクセスを試みるクライアントに対して、ロック有効中は待機するよう抑制できる。

query_prealloc_size

クエリの解析および実行に使用する永続バッファ サイズ。このバッファはクエリ間でも開放しない。頻繁に複雑なクエリを発行する場合、query_prealloc_sizeの値を大きくして、クエリ実行時のメモリ割り当て回数を減らすことになるため、パフォーマンスを改善できる可能性がある。

range_alloc_block_size

範囲の最適化で割り当てるブロックのサイズ。

read_buffer_size

順次スキャン (全件) を行うときに各スレッドが割り当てるバッファ サイズ。バイトで指定する。このスキャンを何度も行う場合には、この値を大きくする。デフォルトは 131072。

read_only

レプリケーション スレーブ サーバで、この値を ON に設定すると、サーバが SUPER 権限を持つユーザ以外からの更新ができない。スレーブ サーバにおいては、マスタ サーバからの更新だけを許容し、クライアントからの要求を無視するようなる。この動作は TEMPORARY テーブルには使えない。

read_only は GLOBAL 変数として存在するために、SUPER 権限が必要な値への変更になる。マスタ サーバで read_only に変更すると、スレーブ サーバで複製できなくなる。この値は、マスタの設定とは独立しているスレーブ サーバで行う。

MySQL 5.1.15 以降は、次のことに注意する。

read_rnd_buffer_size

ソートしたレコードを読み出すときのバッファサイズを指定する。ディスク検索を行わないように、レコードをこのバッファから読み取る。この値を大きく設定すると、ORDER BY のパフォーマンスを大幅に向上できる。しかし、これはスレッド固有の変数であるため、これをグローバル値を大きな値で設定すべきではない。したがって、大量のクエリを実行するときにだけ、クライアント内のセッション値を変更する。

relay_log_purge

リレー ログ ファイルが不必要になったときの自動削除フラグを設定する。デフォルトは 1 (ON)。

rpl_recovery_rank

この変数は使用していない。

secure_auth

--secure-auth オプションを付けて MySQL サーバを起動する場合、MySQL サーバは古い形式 (4.1 より前) のパスワードを認証しない。 このときの値は ON (ブロック)。接続をブロックしないようにするには、OFF にする。

これによりネットワーク セキュリティが不安定な場合など、古い形式を採用しているパスワードでの接続を許可しないようにするには、このオプションを有効にする。

このオプションを有効にしたときに、権限テーブルが 4.1 よりも前の形式である場合には、起動時にサーバ エラーが発生する。 項B.1.2.3. 「Client does not support authentication protocol」 を参照のこと。

server_id

サーバ ID 。--server-id オプションで設定する。これはレプリケーションを行うときなどに、マスタとスレーブのサーバ間でお互いを一意的に認識させるために使用する。

shared_memory

共有メモリに付ける識別子を指定する。Windows 専用。

shared_memory_base_name

共有メモリ接続で使用する共有メモリの名前。 このオプションはWindowsで有効。複数の MySQL インスタンス (サーバ) を一台のマシンで使用している場合に便利。デフォルト名は MYSQL。この名前は大文字と小文字を区別する。

skip_external_locking

OFF ： mysqld が外部ロックを使用している場合。ON ： 外部ロックが無効の場合。

skip_networking

ON ： サーバがローカル接続のみを許可する場合 (非 TCP/IP)。Unix では、ローカル接続に Unix ソケット ファイルを使用。Windows では、名前付きパイプまたは共有メモリを使用。NetWare では、TCP/IP 接続をサポートしている場合のみ。そのため、この変数を ON に設定してはいけない。この変数を ON にするには、--skip-networking オプションを使用する。

skip_show_database

SHOW DATABASES 権限を持たずして SHOW DATABASES を使用するユーザにデータベースを表示しない。これは、他人のユーザ権限のデータベースを表示しないため、セキュリティの向上に役立つ。この効果は SHOW DATABASES 権限の設定オプションに依存する。値を ON にした場合、SHOW DATABASES ステートメントは SHOW DATABASES 権限を持つユーザにだけが使用でき、ステートメントにはすべてのデータベース名を表示する。値を OFF にした場合、SHOW DATABASES はすべてのユーザに対してこのステートメントの発行を許可するが、ユーザがSHOW DATABASES などの権限を持っているデータベースだけの表示になる。

slave_compressed_protocol

マスタとスレーブの両方が圧縮プロトコルをサポートしているかどうか (を指す)。

slave_load_tmpdir

スレーブサーバがレプリケーション データ ( LOAD DATA INFILE ステートメント) を読み込むときに 使用するテンポラリ ディレクトリのパスを指定する。

slave_net_timeout

読み込みを中断するまで、マスタ/スレーブ接続からのデータを待機する秒数。タイムアウトは TCP/IP 接続にだけ適用。Unix ソケット ファイルを介した接続や、名前付きパイプ、共有メモリには適用しない。

slave_skip_errors

スレーブがスキップ (無視) するレプリケーション エラー。

slave_transaction_retries

InnoDB デッドロック、InnoDB の innodb_lock_wait_timeout、NDBCluster の TransactionDeadlockDetectionTimeout または TransactionInactiveTimeout を越えた場合、レプリケーション スレーブの SQL スレッドはトランザクションの実行に失敗する。そのときに、エラーで停止する前に、自動試行する回数のことを slave_transaction_retries 回と定義する。デフォルトでは 10 回。

slow_launch_time

スレッドの作成にこの値（秒単位）より時間がかかると、サーバが Slow_launch_threads ステータス変数 (カウンタ) をインクリメントする。

slow_query_log

スロー クエリ ログが有効になっているかどうか (を指す)。値が 0 (または OFF) の場合、ログしない。値が 1 (または ON) の場合、ログする。デフォルトは --log-slow-queries オプションを設定しているかどうかによる。ログ出力先は log_output システム変数で制御する。値を NONE にした場合、ログできるようにしていても、ログ エントリを書き込まない。slow_query_log は MySQL 5.1.12 からの導入。

slow_query_log_file

スロー クエリ ログ ファイルの名前。デフォルトは host_name-slow.log 。初期値は --log-slow-queries オプションで変更可能。(MySQL 5.1.12 での追加)

socket

Unix 環境で、ローカル接続に使用するソケット ファイル パス。デフォルトは /tmp/mysql.sock になっている。配布用の形式によっては、ディレクトリが異なる場合がある。たとえば、 RPM の /var/lib/mysql など。

Windows環境では、ローカル接続に使用する名前付きパイプ名のこと。デフォルトは MySQL 。文字の大小区別なし。

sort_buffer_size

ソートを実行する必要のあるスレッドがこのサイズのバッファを割り当てる。ORDER BY または GROUP BY などの操作を速くするには、この値を大きくする。 項B.1.4.4. 「Where MySQL Stores Temporary Files」 を参照のこと。

sql_mode

現在のSQLモード。この値は動的に変更することが可能。項4.2.6. 「SQL モード」 を参照のこと。

sql_slave_skip_counter

スレーブ サーバが無視するマスタからのイベント数。項12.6.2.6. 「SET GLOBAL SQL_SLAVE_SKIP_COUNTER 構文」 を参照のこと。

ssl_ca

SSL CA 証明をリストしたファイルのパス。(MySQL 5.1.11 での追加)

ssl_capath

SSL CA 証明書 (PEM形式) があるディレクトリへのパス。(MySQL 5.1.11 での追加)

ssl_cert

セキュリティ上、安全に接続を確立するために使用する SSL 証明書。(MySQL 5.1.11 での追加)

ssl_cipher

SSL 暗号化に使用するサイファ (暗号鍵) のリスト。サイファ リストは openssl ciphers コマンドと同形式。(MySQL 5.1.11 での追加)

ssl_key

セキュリティ上、安全に接続を確立するために使用する SSL キー ファイル名。(MySQL 5.1.11 での追加)

storage_engine

デフォルトのストレージ エンジン (テーブル タイプ)。サーバ起動時にストレージ エンジンを設定するには、--default-storage-engine オプションを使用する。項4.2.2. 「コマンド オプション」 を参照のこと。

sync_binlog

この値が正数の場合、MySQL サーバはバイナリ ログへこの sync_binlog 回書き込みを行い、それごとにディスクへ同期する (fdatasync() を使用)。オートコミットモードでは、一つの SQL 文を発行毎に、ログ書き込みとなる。それ以外のモードでは、トランザクションごとの書き込みになる。デフォルト値は 0 で、ディスクへの同期は行わないことを示す。値を 1 にすると、最も安全な設定となる。これはクラッシュした場合などに失うものが、1 ステートメントあるいは1 トランザクションに留まるためである。しかし、これはパフォーマンスを遅くするため、対応策としては、同期を高速化するために、バッテリ バックアップ式キャッシュをディクスに持たせるなどする。

sync_binlog 値の 0 (デフォルト) は、追加フラッシュは行わないことを示す。これはフラッシュが OS に依存する。

sync_frm

値を 1 とした場合に、テンポラリ以外のテーブルを作成すると、.frm ファイルを ディスクへ同期する (fdatasync() を使用)。これは処理スピードを遅くするが、クラッシュに対して安全である。デフォルトは 1。

system_time_zone

サーバ システムのタイム ゾーン。サーバが起動するときは、マシンのデフォルトタイムゾーンを継承する。これは サーバを起動したユーザアカウントの環境やスタートアップ スクリプトのオプションなどで変更可能。値は system_time_zone を設定する。通常、タイム ゾーンは TZ 環境変数で指定する。または mysqld_safe スクリプトでの --timezone オプションでも指定可能。

system_time_zone と time_zone は別物である。両者の値は同値であることもあるが、後者はクライアント接続毎にタイムゾーンを初期化する変数である。項4.10.8. 「MySQL サーバのタイム ゾーン サポート」 を参照のこと。

table_cache

MySQL 5.1.3 前まで、table_open_cache と呼ばれていた。 MySQL 5.1.3 以降は table_open_cache を使用する。

table_definition_cache

定義キャッシュに保存できるテーブル定義数。テーブル数が多い場合に、テーブルを開けるスピードを速めるために、大きなテーブル定義キャッシュを作成できる。通常のテーブル キャッシュと比較すると、テーブル定義キャッシュが必要とするスペースが小さく、ファイル記述子を使用しない。(MySQL 5.1.3 以降)

table_lock_wait_timeout

テーブル レベル ロックで待機する時間 (秒) を指定する。デフォルトのタイムアウトは 50 秒。タイムアウトは接続でカーソルを開けるとアクティブになる。SUPER 権限を保持していれば、ランタイムにグローバル設定可能。

table_open_cache

すべてのスレッドに対するオープン テーブルの数 (キャッシュする最大テーブル数)。この値を大きくするということは、mysqld が要求するファイル記述子の数を増やすということ。Opened_tables ステータス変数をチェックしてテーブル キャッシュを増やす必要があるかどうかを調べる。項4.2.5. 「ステータス変数」 を参照のこと。Opened_tables の値が大きく、FLUSH TABLES を頻繁に行わない場合 (単にテーブルの開閉を強制するだけ)、table_open_cache 変数の値を増やす必要がある。テーブル キャッシュに関する詳細は 項6.4.8. 「MySQL でのテーブルのオープンとクローズの方法」 を参照のこと。MySQL 5.1.3 前には、table_cache と呼ばれていた。

table_type

storage_engine のシノニム。MySQL 5.1 では storage_engine を使用。MySQL 5.2 では、table_type は削除されている。

thread_cache_size

再利用のためにキャッシュ可能なスレッド数。クライアントが接続を切断したときに、以前のスレッド数が thread_cache_size 以下であれば、そのクライアントのスレッドはキャッシュに入る。新しいスレッドはすべてキャッシュから取り込まれ、キャッシュが空の場合のみ、新しいスレッドが作成される。新しい接続が多く発生する場合、この変数を大きくすることによりパフォーマンスを向上できる （スレッド実装が既に理想的な状態であれば、それほどパフォーマンスは向上しない）。Connections および Threads_created などのステータス変数の差異を調べると、スレッド キャッシュの効率性を確認できる。詳細は 項4.2.5. 「ステータス変数」 を参照のこと。

thread_concurrency

Solaris では、mysqld がこの値を伴う thr_setconcurrency() を呼び出す。アプリケーションに、同時に実行する理想的なスレッド数を提供する。

thread_stack

各スレッドのスタック サイズ。crash-me で検出する制限の多くは、この値に依存する。通常の操作ではデフォルト (192 KB) で十分である。項6.1.4. 「MySQL ベンチマークスィート」 を参照のこと。

time_format

この変数は実装していない。

time_zone

現在のタイムゾーン。この変数はクライアント接続毎にタイム ゾーンを初期化する。デオフォルトは 'SYSTEM' 、つまり system_time_zone「の値を使う」 ということ。サーバ起動時に --default-time-zone オプションで明示的に指定できる。項4.10.8. 「MySQL サーバのタイム ゾーン サポート」 を参照のこと。

timed_mutexes

InnoDB ミューテックスをカウントしているかどうかを制御する。この値を 0 または OFF (デフォルト) に設定すると、ミューテックス カウントは無効になる。この値を 1 または ON に設定すると、ミューテックス カウントは有効になる。このカウントを有効にすると、SHOW ENGINE INNODB MUTEX からの出力の os_wait_times 値は、OS が待機した回数 (ms) を示す。それ以外では、この値は 0 である。

tmp_table_size

メモリ内のテンポラリ テーブルの最大サイズ。実際の限度は max_heap_table_size や tmp_table_size の値より小さい値になる。メモリ内テンポラリ　テーブルが制限値を超えると、MySQL はこれを自動的にディスク内の MyISAM テーブルにする。高度な GROUP BY クエリを展開する場合にメモリが沢山あるときは、 tmp_table_size (必要に応じて、max_heap_table_size も) の値を増やす。

tmpdir

テンポラリ ファイルとテンポラリ テーブルのディレクトリ。この変数はラウンド ロビン式の複数のパスのリストをセットするときに使用する。Unix で、パスはコロン (‘:’) で区切り、Windows、NetWare、OS/2 などではセミコロン (‘;’) で区切る。

複数ディレクトリ機能は、物理ディスク間で負荷を分担するときに使用する。MySQL サーバが レプリケーション スレーブである場合、tmpdir を使用して、メモリ ベースのシステムファイルまたはサーバ ホスト (OS) 再起動時に内容が消去されるディレクトリを指定しない。これは、レプリケーション スレーブが、マシンがリブートした場合や LOAD DATA INFILE 文の処理中であった場合などに対応するために、テンポラリのテーブルやファイルを必要とするため。もしこのディレクトリからテンポラリ ファイルが消えた場合は、サーバ再起動時にレプリケーション エラーが発生する。しかし、MySQL 4.0.0 以降を使用している場合は、slave_load_tmpdir 変数を使用して、スレーブのテンポラリ ディレクトリを設定できる。その場合、スレーブは通常の tmpdir 値を使用しないので、tmpdir を適切な (非永続的) 位置に設置する (スレーブサーバはこのパスを使用することになる)。

transaction_alloc_block_size

メモリ ブロックの割り当てサイズ （byte)。 このメモリは、コミットするときにバイナリログへ書き込むための トランザクション内クエリを保存するために使用する。transaction_prealloc_size の説明を参照のこと。

transaction_prealloc_size

永続的バッファの (初期) サイズをtransaction_prealloc_size と呼ぶ。メモリが不十分が原因で、このプール (領域) で割り当てが十分に行えない場合、transaction_alloc_block_size でプールの値を大きくする。トランザクションが済むと、プールは transaction_prealloc_size バイトで切り捨てになる

単一トランザクション内のすべてのクエリをバッファ内に収めるように、transaction_prealloc_sizeを大きくすると、malloc() システム コールを避けることができる。

tx_isolation

基準にするトランザクション隔離レベル。 デフォルト値は REPEATABLE-READ 。

この変数は SET TRANSACTION ISOLATION LEVEL ステートメントで設定する。項12.4.6. 「SET TRANSACTION 構文」 を参照のこと。tx_isolation を直接、隔離レベル名に設定する場合に、スペースを含むときには、その名前を引用符で囲み、そのスペースをダッシュと置換する。たとえば、

SET tx_isolation = 'READ-COMMITTED';

updatable_views_with_limit

更新の許可するかどうかを制御する。ビューに基準テーブルで定義したプライマリ キーのすべてのカラムが含まれていない場合に、更新ステートメントで LIMIT 節を含んでいたら、そのビューを更新するかどうか、ということである。このような更新は GUI ツールなどから生成される。ここでの更新は UPDATE または DELETE ステートメントのこと。ここでのプライマリ キーとは PRIMARY KEY または UNIQUE インデックスのことで、NULL をカラムに含まない。

この変数の値は 2 種類ある。

version

サーバのバージョン番号。

version_comment

configure スクリプトには、MySQL を構築するときにコメントを指定できる --with-comment オプションがある。そのコメントの値。

version_compile_machine

マシンのタイプ、または MySQL構築時のアーキテクチャ。

version_compile_os

MySQL構築時のオペレーティング システムのタイプ。

wait_timeout

対話式ではない接続 (反応の無い接続) を終了する前に、サーバがアクティビティを待機する秒数。このタイムアウトは TCP/IP 接続と Unix のソケット ファイル接続だけに適用。名前付きパイプと共有ファイルの接続には使用できない。

スレッド起動時に、セッション wait_timeout 値は、wait_timeout グローバル値、または interactive_timeout グローバル値で初期化するが、これはクライアントのタイプによる。(CLIENT_INTERACTIVE の接続オプションを mysql_real_connect()) に定義する。) interactive_timeout の説明も参照のこと。

サーバが起動するとき、すべてのグローバル変数をデフォルト値に初期化する。このデフォルト値はコマンド ラインまたはオプション ファイルなどで指定できる。オプションに関しては、項3.3. 「プログラム･オプションの指定」 を参照のこと。

サーバにはクライアントが接続するセッション変数の組み合わせがある。クライアントのセッション変数は、グローバル変数に呼応するカレント値を使用して接続タイムで初期化する。たとえば、クライアントの SQL モードは、セッション sql_mode 値で制御し、クライアントが sql_mode のグローバル値に接続するときに初期化する。

変数がグローバルであることを明示するには、GLOBAL または @@global. で名前を先行する。グローバル変数を設定するには SUPER 権限が必要。

変数がセッションであることを明示するには、SESSION、@@session.、@@ などで名前を先行する。セッション値の設定には特別の権限は不要であるが、クライアントだけがそのセッション変数を変更できる。別のクライアントからはできない。

LOCAL および @@local. は SESSION と @@session. のシノニム。.

修飾子がない場合は、SET でセッション変数を変更する。

Aborted_clients

接続を適切に閉じないままクライアントが終了したことが原因で中断した接続の数。項B.1.2.10. 「Communication Errors and Aborted Connections」 を参照のこと。

Aborted_connects

MySQLサーバに接続しようとして失敗した回数。 項B.1.2.10. 「Communication Errors and Aborted Connections」 を参照のこと。

Binlog_cache_disk_use

binlog_cache_sizeの値を超えてテンポラリ ログ キャッシュを使用したトランザクションの回数。トランザクションからステートメントを保存するためにテンポラリ ファイルを使用した場合。

Binlog_cache_use

テンポラリ バイナリ ログ キャッシュを使用したトランザクションの回数。

Bytes_received

すべてのクライアントから受信したバイト数。

Bytes_sent

すべてのクライアントへ送信したバイト数。

Com_xxx

Com_xxx ステートメントのカウンタ値は、それぞれの xxx ステートメントを実行した回数を示す。それぞれのステートメント タイプをそれぞれカウントする。たとえば、 DELETE で Com_delete を 1 とし、INSERTで Com_insert を 1 としてカウントする。クエリ結果がクエリ キャッシュから返される場合は、サーバは Qcache_hits ステータス値の増加になる。Com_select ではないことに注意が必要。項4.13.4. 「クエリ キャッシュのステータスと保守」 を参照のこと。

Com_stmt_xxx 値のすべては、準備された文 (prepared statement) の引数が未知、または実行中にエラーが発生した場合でも増加する。つまり、この値は、要求発行回数に対応し、要求を完了 (成功) した回数ではない。

Com_stmt_xxx ステータス変数は次の通り。

これらの変数は、準備された文 (prepared statement)。名前は ネットワーク レイヤーでし使用した COM_xxx

のコマンド セットを示す。つまり、mysql_stmt_prepare() や mysql_stmt_execute() など、準備されたステートメントの API コールを実行すると、これらの値は増加する。PREPARE、EXECUTE、DEALLOCATE PREPARE は Com_stmt_prepare、Com_stmt_execute、Com_stmt_close に対応しているので、同様に増加する。さらに、MySQL 4.1.3 から実装しているため、古いステートメントのカウンタ値は、PREPARE、EXECUTE、DEALLOCATE PREPARE が Com_prepare_sql、Com_execute_sql、Com_dealloc_sql に対応しているので、これも同様に増加する。Com_stmt_fetch はカーソルからフェッチしたときにネットワーク往復を発行した合計回数のこと。

Compression

接続でクライアント/サーバ間の圧縮プロトコルを 使用しているかどうか (を指す)。(MySQL 5.1.2での追加)

Connections

(成功/不成功に関わらず) MySQL サーバへの接続試行回数。

Created_tmp_disk_tables

ステートメント実行中に、ディスク上に作成された暗黙的テンポラリテーブルの数。

Created_tmp_files

mysqld が生成したテンポラリ ファイルの数

Created_tmp_tables

ステートメント実行中に、メモリ上に作成された暗黙的テンポラリテーブルの数。Created_tmp_disk_tables の値が大きい場合には、tmp_table_size の値も大きくすることによって、テンポラリテーブルをディスクベースではなくメモリベースにすることもできる。

Delayed_errors

エラー発生（duplicate key の可能性）により、INSERT DELAYED で書き込まれたレコードの数。

Delayed_insert_threads

INSERT DELAYED ハンドラ スレッドの数。

Delayed_writes

INSERT DELAYED で書き込んだレコードの数。

Flush_commands

FLUSH コマンドの実行回数。

Handler_commit

内部 COMMIT コマンド数。

Handler_delete

テーブルからレコードを削除した回数。

Handler_discover

MySQL サーバが NDB Cluster ストレージエンジンに 指定の名前を持ったテーブル認識しているかどうかを問い合わせることができる。この操作をディスカバリー (discovery) と呼ぶ。 Handler_discover 値は、ディスカバーした回数。

Handler_prepare

2 フェーズ コミット操作の準備フェーズのカウンタ。

Handler_read_first

インデックスから最初のエントリを読み取った回数。 この値が大きい場合、サーバが何回もフル インデックス スキャンを実行している可能性がある。たとえば、SELECT col1 FROM foo を実行したときに、col1 がインデックスになっている場合など。

Handler_read_key

キーに基づいたレコード読み込み要求を受けた回数。この値が大きい場合、クエリをテーブルへ適切にインデックス化していることを示す。

Handler_read_next

キー順序で次レコードの読み込み要求を受けた回数。範囲指定をしてインデックス カラムに対してクエリを実行すると、これがインクリメントする。インデックス スキャンを実行した場合もインクリメントする。

Handler_read_prev

キー順序で前レコードの読み込み要求を受けた回数。この読み取り方法は主に、ORDER BY ... DESC の最適化に使用している。

Handler_read_rnd

固定位置に基づいたレコード読み込み要求を受けた回数。結果のソートを必要とするクエリを多く実行すると、この値が大きくなる。MySQL でテーブルの全件スキャンや適切にキーを使えない結合を持ったクエリがある可能性がある。

Handler_read_rnd_next

データ ファイルで次レコードの読み取り要求を受けた回数。テーブル スキャンの実行が多いと、この値が大きくなる。これは通常、テーブルに適切なインデックス化できない、またはインデックスを利用できないクエリを発行していることを意味する。

Handler_rollback

ROLLBACKを内部的 (ストレージ エンジン) に実行した回数。

Handler_savepoint

内部的 (ストレージ エンジン) に セーブポイント (savepoint) の配置要求回数。

Handler_savepoint_rollback

内部的 (ストレージ エンジン) に セーブポイント (savepoint) へロールバック要求回数。

Handler_update

テーブル内のレコードの更新要求回数。

Handler_write

テーブルへのレコードの挿入要求回数。

Innodb_buffer_pool_pages_data

データがあるページ数 (ダーティ または クリーン)。

Innodb_buffer_pool_pages_dirty

ダーティ ページの数。

Innodb_buffer_pool_pages_flushed

InnoDB がキャッシュするために使用するメモリ バッファの数。

Innodb_buffer_pool_pages_free

空き容量

Innodb_buffer_pool_pages_latched

InnoDB のメモリ バッファでラッチした数。データが読み込みまたは書き込みの対象になっていて、フラッシュまたは削除が何らかの理由でできない状態。

Innodb_buffer_pool_pages_misc

レコード ロックまたはアダプティブなハッシュ インデックスなどにより、オーバーヘッドの割り当てになったビジー (busy) 状態のデータ。この値は Innodb_buffer_pool_pages_total ? Innodb_buffer_pool_pages_free ? Innodb_buffer_pool_pages_data で算出。

Innodb_buffer_pool_pages_total

ページのメモリ バッファの合計サイズ。

Innodb_buffer_pool_read_ahead_rnd

InnoDB が開始した 「random (ランダム)」 先読みの数。大型テーブルのクエリ スキャンをランダムに行うと発生する。

Innodb_buffer_pool_read_ahead_seq

InnoDB が開始した順次的な先読み数。InnoDBが 順次的にフル テーブル スキャンを行うときに発生する。

Innodb_buffer_pool_read_requests

InnoDB が行った論理読み込みの数

Innodb_buffer_pool_reads

InnoDBがバッファ プールの内容を利用できず、シングル ページ読み込みを行わなければならなかった論理読み込みの回数

Innodb_buffer_pool_wait_free

' 通常、InnoDB バッファ プールへの書き込みはバックグラウンドで行うが、ページの読み込みまたは作成を行う必要があるのに対して、クリーン ページが得られない場合に、まずそのページがフラッシュするまで待つ必要がある。このカウンタは、その待機回数をカウントする。バッファ プールの値が適切に設定すると、この値は小さくなる。

Innodb_buffer_pool_write_requests

InnoDB バッファープールへの書き込み数。

Innodb_data_fsyncs

ここまでの fsync() 操作数。

Innodb_data_pending_fsyncs

現在の fsync() 操作保留 (pending) の数。

Innodb_data_pending_reads

現在の読み込み保留の数。

Innodb_data_pending_writes

現在の書き込み保留の数。

Innodb_data_read

ここまでのデータの読み込み量 (単位:バイト)。

Innodb_data_reads

データ読み込みの合計数。

Innodb_data_writes

データ書き込みの合計数。

Innodb_data_written

ここまでのデータの書き込み量 (単位:バイト)。

Innodb_dblwr_writes, Innodb_dblwr_pages_written

二重書き込みの実行回数と、二重書き込みが発生したページ数。項13.5.14.1. 「InnoDB ディスク I/O」 を参照のこと。.

Innodb_log_waits

ログ バッファが小さすぎるために、作業を継続する前にフラッシュ要求で待機した回数。

Innodb_log_write_requests

要求ログ書き込みの回数。

Innodb_log_writes

ログ ファイルへの物理的な書込みの回数。

Innodb_os_log_fsyncs

ログ ファイルの fsync() 書き込みをした回数。

Innodb_os_log_pending_fsyncs

fsync() 待ちのログ ファイル数。

Innodb_os_log_pending_writes

ログ ファイルの書き込みの保留回数。

Innodb_os_log_written

ログ ファイルへの書き込みの回数。

Innodb_page_size

コンパイル時の InnoDB ページ サイズ (デフォルト 16KB)。多くの値がページ カウントの対象になり、ページ サイズは、それらを容易なバイト変換を可能にする。

Innodb_pages_created

作成したページの数。

Innodb_pages_read

読み込みしたページの数。

Innodb_pages_written

書き込みしたページの数。

Innodb_row_lock_current_waits

現在待機している行ロック (row lock) の数。

Innodb_row_lock_time

行ロック (row lock)、列の獲得に使用した合計時間 (単位： ミリ秒)。

Innodb_row_lock_time_avg

行ロック (row lock)、列の獲得に使用した平均時間 (単位： ミリ秒)。

Innodb_row_lock_time_max

行ロック (row lock)、列の獲得に使用した最長時間 (単位： ミリ秒)。

Innodb_row_lock_waits

行ロックで待機する必要があった回数。

Innodb_rows_deleted

InnoDB テーブルから削除したレコード数。

Innodb_rows_inserted

InnoDB テーブルへの挿入レコード数。

Innodb_rows_read

InnoDB テーブルからの読み込みレコード数。

Innodb_rows_updated

InnoDB テーブルでの更新レコード数。

Key_blocks_not_flushed

変更後に、まだディスクに未フラッシュのキー キャッシュのキー ブロックの数。

Key_blocks_unused

キー キャッシュの未使用ブロックの数。どれだけ使用しているか決定するためにこの値を使用する。項4.2.3. 「システム変数」 で key_buffer_size に関する説明を参照のこと。

Key_blocks_used

キー キャッシュのブロックの使用数。この値は、これまで同時使用したブロックの最大数を指す頂点。

Key_read_requests

キャッシュからキー ブロックを読み込んだリクエスト数。

Key_reads

ディスクからのキーブロックの物理的読み込み回数。Key_reads が大きい場合、key_buffer_size の値が小さい可能性がある。キャッシュ ミス率は Key_reads/Key_read_requestsと計算する。

Key_write_requests

キャッシュへのキーブロックの書き込んだリクエスト数。

Key_writes

ディスクへのキー ブロックの物理的な書き込み回数。

Last_query_cost

クエリ オプティマイザが計算し、最後にコンパイルしたクエリの全コスト。同じクエリの異なるクエリ プランのコストを比較するときに使用する。デフォルト値 0 は、クエリがまだ未コンパイルであることを意味する。Last_query_cost にはセッション スコープがある。

Max_used_connections

サーバが起動してから同時使用した接続の最大数。

Ndb_cluster_node_id

サーバが MySQL Cluster ノードとして作用している場合、この値はそのクラスタのノード ID。

サーバが MySQL Cluster の一部ではない場合、この値は 0 。

Ndb_config_from_host

サーバが MySQL Cluster の一部である場合、この値は Cluster マネージメント サーバのホスト名または IP アドレスで、コンフィギュレーション データを取得する。

サーバが MySQL Cluster の一部ではない場合、この値は空文字列 。

MySQL 5.1.12 以前では、この変数は Ndb_connected_host と呼ばれていた。

Ndb_config_from_port

サーバが MySQL Cluster の一部である場合、この値はポート番号で、ここから、コンフィギュレーション データを取得する Cluster マネージメント サーバに接続。

サーバが MySQL Cluster の一部ではない場合、この値は 0 。

MySQL 5.1.12 以前では、この変数は Ndb_connected_port と呼ばれていた。

Ndb_number_of_data_nodes

サーバが MySQL Cluster の一部である場合、この値はクラスタのデータ ノードの数。

サーバが MySQL Cluster の一部ではない場合、この値は 0 。

MySQL 5.1.12 以前では、この変数は Ndb_number_of_storage_nodes と呼ばれていた。

Not_flushed_delayed_rows

INSERT DELAY 行列への書き込み待ちの行数。

Open_files

開いているファイルの数。

Open_streams

開いているストリームの数。(主に、ログの記録で使用）

Open_tables

開いているテーブルの数。

Opened_tables

これまでに開いたテーブル数。Opened_tables の値が多い場合、table_open_cacheの値が小さい可能性がある。

Prepared_stmt_count

準備されたステートメントの現在の数。max_prepared_stmt_count で最大値を与える。(MySQL 5.1.14 での追加)

Qcache_free_blocks

クエリ キャッシュ内の空きメモリ ブロックの数

Qcache_free_memory

クエリ キャッシュ内の空きメモリ ブロック量

Qcache_hits

クエリ キャッシュ ヒットの数。

Qcache_inserts

キャッシュに追加したクエリ数。

Qcache_lowmem_prunes

メモリ不足を解消するために、クエリ キャッシュから削除されたクエリの数。

Qcache_not_cached

キャッシュしないクエリの数。(キャッシュできないか、または query_cache_type でキャッシュしない設定)

Qcache_queries_in_cache

クエリ キャッシュに登録したクエリ数。

Qcache_total_blocks

クエリ キャッシュの合計ブロック数。

Questions

サーバに送信したクエリ数。

Rpl_status

フェイル セーフ (安全装備) レプリケーションのステータス。未実装。

Select_full_join

インデックスを使用しない結合の数 (テーブル スキャン)。この値が 0 でない場合、テーブルのインデックスを調べること。

Select_full_range_join

関連テーブルで範囲検索を使用した結合の数。

Select_range

ファースト テーブルで範囲指定した部分を使用した結合の数。 通常は、この数値が大きくても、それほど致命的な問題にはならない。

Select_range_check

キーなしの結合の数。これは、それぞれのレコードのあとにキー使用をチェックする。この値が 0 でない場合、テーブルのインデックスをチェックする必要がある。

Select_scan

ファースト テーブルのフル スキャンを行った結合の数。

Slave_open_temp_tables

スレーブの SQL スレッドで現在開いているテンポラリ テーブルの数。

Slave_running

サーバがマスタに接続しているスレーブの場合は、この値は ON。

Slave_retried_transactions

起動時から、レプリケーション スレーブの SQL スレッドがトランザクションを再試行した回数のこと。

Slow_launch_threads

slow_launch_time 秒よりも、作成時間を要したスレッドの数。

Slow_queries

slow_launch_time 秒よりも、作成時間を要したクエリの数。項4.11.5. 「スロー クエリ ログ」 を参照のこと。

Sort_merge_passes

ソート アルゴリズムで必要としたマージ パスの回数。この値が大きい場合は、sort_buffer_size の値を大きくすることを検討する。

Sort_range

範囲指定のソートを行った回数。

Sort_rows

ソートしたレコードの数。

Sort_scan

テーブル スキャンでソートした回数。

Ssl_xxx

SSL接続に使用する変数 (ステータス)。

Table_locks_immediate

テーブル ロックを直ちに実行した回数。

Table_locks_waited

テーブル ロックをすぐには実行できず、待機が必要だった回数。この値が大きい場合、パフォーマンス上の問題がある。まずクエリを最適化し、次にテーブルを分割するかレプリケーションを行う。

Tc_log_max_pages_used

mysqld で使用するログのメモリ マップ実装では、それ自体が内部の XA トランザクションのリカバリに対してトランザクション コーディネータとして作用するとき、この値は、サーバが起動してからログに使用したページの最大数を示す。Tc_log_max_pages_used と Tc_log_page_size の積が常に、ログ サイズよりも極端に小さい場合は、そのサイズは必要以上に大きいことを示し、減らすことを検討する。このサイズは、--log-tc-size オプションで指定できる。現在、この変数は未使用。これはバイナリ ログをベースとしたリカバリには不要で、メモリ マップのリカバリ ログ方法は、ストレージ エンジンが2 フェーズ コミットより大きなものを許容できる場合を除き、使用しない。InnoDB は唯一、対応できるエンジンである。

Tc_log_page_size

XA リカバリ ログのメモリ マップ実装のページ サイズ。デフォルトには getpagesize() を使用して値を決める。現在、この変数は未使用で、その理由は、Tc_log_max_pages_used に記述したものと同じである。

Tc_log_page_waits

リカバリ ログのメモリ マップ実装で、この値は、サーバがトランザクションにコミットできず、ログの空きを待機する必要があると、その度にインクリメント (増加) する。この値が大きい場合、--log-tc-size オプションでログ サイズの増加を検討する。バイナリ ログをベースとしたリカバリでは、この値は、バイナリ　ログが 2 フェーズ コミット中のために閉じることができない場合に、その度にインクリメントする。これは、対象となるすべてのトランザクションが完了するまで待機となる。

Threads_cached

スレッド キャッシュ内のスレッド数。

Threads_connected

現在開いている接続の数。

Threads_created

接続を処理で作成されたスレッドの数。Threads_created の値が大きい場合、thread_cache_size の値を大きくして キャッシュ サイズを増やす。キャッシュヒット率の計算は Threads_created/Connections とする。

Threads_running

スリープ状態になっていないスレッドの数。

Uptime

サーバ起動時からの経過秒数。

ANSI

このモードは、標準 SQL とより同調できるように、シンタックス (構文) と動作を変更する。

STRICT_TRANS_TABLES

指定された値をトランザクション テーブルに挿入できない場合、クエリの実行を中断する。非トランザクション テーブルでは、値が 1 行ステートメントの場合、または複数行ステートメントの最初の行である場合に、クエリを中断する。詳細は、このセクションでの後述を参照のこと。

TRADITIONAL

MySQL を 「従来型の」 SQL データベース システムにように動作させる。このモードの最もシンプルな特徴は、カラムに不正値を挿入するときに、「警告ではなく、エラー メッセージ」 を返すことである。注意：INSERT/UPDATE は、エラーを認識すると即座に中断する。そのため、非トランザクション式のストレージ エンジンを使用している場合は、使用しない (推奨)。エラー前に変更したデータがロール バックしないため、更新が 「部分的に」 完了してしまうことがある。

ALLOW_INVALID_DATES

日付の完全チェックを行わずに、月 は 1 から 12 まで、日は 1 から 31 までであることだけをチェックする。これは、たとえば、Web アプリケーションなどで年月日をそれぞれのフィールドで取得し、(日付に関するバリデーションなしで) ユーザが指定した通りに保存する場合に便利である。このモードは DATE と DATETIME のカラムに適用する。TIMESTAMP カラムは常に有効な日付を必要とするため、対象外である。

サーバでは月日の値は正当である必要があり、単に 1 から 12 そして 1 to 31 の範囲であるだけではいけない。Strict Mode を無効化した場合、'2004-04-31' のような入力は無効とみなし、'0000-00-00' と修正される。そのときには、警告が出される。Strict Mode を有効にした場合、無効とみなす日はエラーとなる。'2004-04-31' を許すには、ALLOW_INVALID_DATES を有効にする。

ANSI_QUOTES

引用文字 ‘`’ のように、‘"’ を識別子として扱う。文字列の引用文字ではない。このモードを有効にした場合には、‘`’ を識別子として使用できる。ANSI_QUOTES を有効にした場合には、識別子として解釈されるため、リテラル文字列の引用には二重引用符を使用できなくなる。

ERROR_FOR_DIVISION_BY_ZERO

INSERT または UPDATE 中に、0で除算 (または MOD(X,0)) すると、Strict Mode でエラーを生成する (そうでなければ、警告)。このモードを有効にしない場合、MySQL は 0 除算 に対して、NULL を返す。INSERT IGNORE または UPDATE IGNORE では、MySQL が 0 除算に対して警告を生成するが、操作結果は NULL になる。

HIGH_NOT_PRECEDENCE

NOT 演算子の優先順位は、NOT a BETWEEN b AND c を NOT (a BETWEEN b AND c) として構文解析するようなプログラム式である。古い MySQL バージョンでは、(NOT a) BETWEEN b AND c として構文解析している。以前の優先順位動作は、SQL モードの HIGH_NOT_PRECEDENCE を使用すると可能になる。

mysql> SET sql_mode = '';
mysql> SELECT NOT 1 BETWEEN -5 AND 5;
        -> 0
mysql> SET sql_mode = 'HIGH_NOT_PRECEDENCE';
mysql> SELECT NOT 1 BETWEEN -5 AND 5;
        -> 1

IGNORE_SPACE

関数名と ‘(’ 文字のスペースを許可する。これは、組込み関数名を予約語として扱うようにする。そのため、関数名と同一の識別子を引用符で囲む必要がある。詳細は 項8.2. 「識別子」 を参照のこと。たとえば、COUNT() という関数があった場合、count をテーブル名として使用すると、次のようなステートメントでエラーが発生する。

mysql> CREATE TABLE count (i INT);
ERROR 1064 (42000): You have an error in your SQL syntax

テーブル名は次のようにする。

mysql> CREATE TABLE `count` (i INT);
Query OK, 0 rows affected (0.00 sec)

IGNORE_SPACEモードは、ユーザ定義関数 (UDF) または格納された関数ではなく、組み込み関数に適用する。IGNORE_SPACEを有効化しているかどうかに関わらず、ユーザ定義関数または格納された関数の後ろにスペースを入れることは常に可能である。

IGNORE_SPACE に関する詳細は、項8.2.4. 「構文解析と解像度のファンクション名」 を参照のこと。

NO_AUTO_CREATE_USER

GRANT 文が自動的に新規ユーザを作成しないようにする。空でないパスワードも指定した場合を除く。

NO_AUTO_VALUE_ON_ZERO

NO_AUTO_VALUE_ON_ZERO は AUTO_INCREMENT カラム処理に影響する。通常。次のシーケンス番号をカラムに生成するときには、NULL または 0 を挿入する。NO_AUTO_VALUE_ON_ZERO は 0 の動作を抑制するため、NULL が次のシーケンス番号を生成する。

このモードでは、0 をテーブルの AUTO_INCREMENT カラムに格納する。しかし、0 を保存するということは、推奨できる方法ではない。たとえば、mysqldump コマンドでテーブルにダンプして、リロードする場合に、MySQL は, 0 という値に遭遇すると、新たなシーケンスン番号を生成し、テーブルにダンプしたものとは異なる内容になるという結果を生む。ダンプ ファイルをリロードする前に NO_AUTO_VALUE_ON_ZERO を有効にすると、この問題を回避できる。現在、mysqldump は、自動的にその出力に、NO_AUTO_VALUE_ON_ZERO を有効にするステートメントを含むようになったので、これまでの問題を回避できる。

NO_BACKSLASH_ESCAPES

文字列内のエスケープ文字としてのバックスラッシュ (‘\’) を無効にする。このモードを有効にすると、バックスラッシュが特殊文字でなく通常の文字として扱われる。

NO_DIR_IN_CREATE

テーブル作成時に、INDEX DIRECTORY と DATA DIRECTORY の命令をすべて無視する。このオプションはスレーブのレプリケーション サーバで役立つ。

NO_ENGINE_SUBSTITUTION

デフォルトのストレージ エンジンの自動置換 (substitution) を防ぐ。これは、CREATE TABLE のようなステートメントが、無効化した、またはコンパイルしたストレージ エンジンを指定するときのこと。エラーで知らせる。

NO_FIELD_OPTIONS

MySQL 独自のカラムオプションを SHOW CREATE TABLE の出力に印字しない。このモードは mysqldump コマンドのポータビリティモードで使用される。

NO_KEY_OPTIONS

MySQL 独自のインデックスオプションを SHOW CREATE TABLE の出力に印字しない。このモードは mysqldump コマンドのポータビリティモードで使用される。

NO_TABLE_OPTIONS

MySQL 特化のテーブル オプション (ENGINE など) を SHOW CREATE TABLE の出力に印字しない。ポータビリティ モードで mysqldump コマンドを使用する。

NO_UNSIGNED_SUBTRACTION

整数引き算操作で、オペランド (演算数) の一つに符号がない場合には、結果を UNSIGNED としてマークしない。つまり、引き算の結果はモードに効力がある場合は常に符号があり、オペランドの一つに符号がない場合でも同様。. たとえば、テーブル t1 のカラム c2 のタイプと、テーブル t2 の c2 のタイプを比較すると、次のようになる。

mysql> SET SQL_MODE='';
mysql> CREATE TABLE test (c1 BIGINT UNSIGNED NOT NULL);
mysql> CREATE TABLE t1 SELECT c1 - 1 AS c2 FROM test;
mysql> DESCRIBE t1;
+-------+---------------------+------+-----+---------+-------+
| Field | Type                | Null | Key | Default | Extra |
+-------+---------------------+------+-----+---------+-------+
| c2    | bigint(21) unsigned |      |     | 0       |       |
+-------+---------------------+------+-----+---------+-------+

mysql> SET SQL_MODE='NO_UNSIGNED_SUBTRACTION';
mysql> CREATE TABLE t2 SELECT c1 - 1 AS c2 FROM test;
mysql> DESCRIBE t2;
+-------+------------+------+-----+---------+-------+
| Field | Type       | Null | Key | Default | Extra |
+-------+------------+------+-----+---------+-------+
| c2    | bigint(21) |      |     | 0       |       |
+-------+------------+------+-----+---------+-------+

ノート： これは BIGINT UNSIGNED はすべての文脈で完全には使用できないことを意味する。項11.8. 「キャスト関数と演算子」 を参照のこと。.

mysql> SET SQL_MODE = '';
mysql> SELECT CAST(0 AS UNSIGNED) - 1;
+-------------------------+
| CAST(0 AS UNSIGNED) - 1 |
+-------------------------+
|    18446744073709551615 |
+-------------------------+

mysql> SET SQL_MODE = 'NO_UNSIGNED_SUBTRACTION';
mysql> SELECT CAST(0 AS UNSIGNED) - 1;
+-------------------------+
| CAST(0 AS UNSIGNED) - 1 |
+-------------------------+
|                      -1 |
+-------------------------+

NO_ZERO_DATE

Strict Mode では、'0000-00-00' は有効な日として扱わない。IGNORE オプションで 「ゼロ」 の日付を挿入する。Strict Mode ではない場合は、この日付は有効になるが、警告が出る。

NO_ZERO_IN_DATE

Strict Mode では、月日に 0 があった場合は、許可されない。IGNORE オプションで併用した場合は、MySQL が '0000-00-00' と入れ替える。Strict Mode ではない場合は、日付は有効になるが、警告が出る。

ONLY_FULL_GROUP_BY

SELECT リストのクエリを許可しない。このリストは GROUP BY 節で名付けていない未集約のカラムを指す。次のクエリは、address が GROUP BY 節で名付づけていないので、このモードを有効にした場合は無効になる。

SELECT name, address, MAX(age) FROM t GROUP BY name;

MySQL 5.1.11 以後、このモードは、GROUP BY 節で名付けていない HAVING. の未集約カラムへのリファレンスを制限する。

PIPES_AS_CONCAT

|| を連結演算子として扱う。 (CONCAT() と同様に。) OR のシノニムとしては扱わない。

REAL_AS_FLOAT

REAL を FLOAT のシノニムとして扱う。デフォルトでは、MySQL が REAL を DOUBLE のシノニムとして扱う。

STRICT_ALL_TABLES

すべてのステーレジ エンジンに対して、Strict Mode を有効にする。無効データは排除の対象になる。詳細は、次のパラグラフを参照のこと。

STRICT_TRANS_TABLES

トランザクションのストレージ エンジンに対して、Strict Mode を有効にする。非トランザクションのストレージ エンジンに対しても可能な場合ある。詳細は次のパラグラフを参照のこと。

STRICT_ALL_TABLES では、MySQL はエラーを返し、残りの行を無視する。そのような場合は、最初の段階の行がまだ挿入中または更新中であり、部分的な更新を得ることになり、それが予期していたものとは異なる可能性がある。これを回避するには、単行ステートメントを使用すると、テーブルを変更することなく、中断できる。

STRICT_TRANS_TABLESでは、MySQL は無効値を、カラムに対して最も近い有効値に置換し、調整した値を挿入する。値が不明である場合は、MySQL は、カラムのデータ タイプに明示的なデフォルト値を挿入する。どちらの場合でも、MySQL はエラーではなく、警告を出し、クエリ処理を続行する。明示的なデフォルトに関しては、項10.1.4. 「データタイプデフォルト値」 を参照のこと。

ANSI

REAL_AS_FLOAT、 PIPES_AS_CONCAT、 ANSI_QUOTES、 IGNORE_SPACE に相当。 項1.8.3. 「ANSIモードでのMySQLの実行」 を参照のこと。

DB2

PIPES_AS_CONCAT、 ANSI_QUOTES、 IGNORE_SPACE、 NO_KEY_OPTIONS、 NO_TABLE_OPTIONS、 NO_FIELD_OPTIONS に相当。

MAXDB

PIPES_AS_CONCAT、 ANSI_QUOTES、 IGNORE_SPACE、 NO_KEY_OPTIONS、 NO_TABLE_OPTIONS、 NO_FIELD_OPTIONS、 NO_AUTO_CREATE_USER に相当。

MSSQL

PIPES_AS_CONCAT、 ANSI_QUOTES、 IGNORE_SPACE、 NO_KEY_OPTIONS、 NO_TABLE_OPTIONS、 NO_FIELD_OPTIONS に相当。

MYSQL323

NO_FIELD_OPTIONS、 HIGH_NOT_PRECEDENCE に相当。

MYSQL40

NO_FIELD_OPTIONS、 HIGH_NOT_PRECEDENCE に相当。

ORACLE

PIPES_AS_CONCAT、 ANSI_QUOTES、 IGNORE_SPACE、 NO_KEY_OPTIONS、 NO_TABLE_OPTIONS、 NO_FIELD_OPTIONS、 NO_AUTO_CREATE_USER に相当。

POSTGRESQL

PIPES_AS_CONCAT、 ANSI_QUOTES、 IGNORE_SPACE、 NO_KEY_OPTIONS、 NO_TABLE_OPTIONS、 NO_FIELD_OPTIONS に相当。

TRADITIONAL

STRICT_TRANS_TABLES、 STRICT_ALL_TABLES、 NO_ZERO_IN_DATE、 NO_ZERO_DATE、 ERROR_FOR_DIVISION_BY_ZERO、 NO_AUTO_CREATE_USER に相当。

--help

ヘルプメッセージを表示し、終了。

--autoclose

NetWare 専用。NetWare では、mysqld_safe がスクリーン表示を行う。mysqld_safe NLM をアンロード (シャットダウン) するときは、デフォルトでスクリーンが消えることはなく、代わりにユーザ入力をプロンプトする。

*<NLM has terminated; Press any key to close the screen>*

NetWare で、自動的にスクリーンを閉じるようにするには、mysqld_safe で --autoclose オプションを使用する。

--basedir=path

基準パス。MySQLをインストールしているディレクトリを指す。

--core-file-size=size

mysqld で作成するコア ファイルのサイズ。このオプション値は ulimit -c へ渡る。

--datadir=path

データ ディレクトリへのパス。

--defaults-extra-file=path

通常のオプションファイルのほかに、読み込むオプション ファイルの名前。このオプションを使用するときは、これをコマンドラインで最初のオプションにする。このファイルが存在しない、またはアクセスできないという場合には、サーバがエラーを出して終了する。

--defaults-file=file_name

通常のオプション ファイルの代わりに読み込むオプション ファイルの名前。このオプションを使用するときには、これをコマンドラインで最初のオプションにする。

--ledir=path

mysqld_safe でサーバをみつけることができない場合、このオプションでサーバがあるディレクトリへのパス探す。.

--log-error=file_name

任意のファイルにエラー ログを書き込む。項4.11.2. 「エラー ログ」 を参照のこと。

--mysqld=prog_name

ledir ディレクトリにある (起動する) サーバ プログラムの名前。このオプションは、MySQL バイナリ配布を使用するが、バイナリ配布外にデータ ディレクトリがある場合に、このオプションを使用する。mysqld_safe でサーバをみつけることができない場合は、 --ledir オプションを使用して、サーバ ディレクトリのパスを探す。

--mysqld-version=suffix

--mysqld オプションと類似のオプション。ここではサーバのプログラム名 (mysqld) のサフィックスだけを指定する。ベース名を mysqld とする。たとえば、--mysqld-version=debug を使用すると、mysqld_safe は ledir ディレクトリの mysqld-debug プログラムを起動する。--mysqld-version の引数が空白の場合、mysqld_safeでは、ledir ディレクトリの mysqld を使用する。

--nice=priority

nice プログラムは任意の値に対してサーバのスケジュール優先順位を設定する。

--no-defaults

オプション ファイルを読まない。このオプションを使用するときは、コマンドラインの最初に置く。

--open-files-limit=count

mysqld が開くファイル数。オプション値は ulimit -n へ渡る。ノート：正確に機能させるには、mysqld_safe を root として立ち上げる。

--pid-file=file_name

ID ファイルのパス名

--port=port_num

TCP/IP 接続時に使用するポート番号。ポート番号は 1024 以上にする。サーバが root システム ユーザで立ち上がっている場合はこの限りではない。

--socket=path

サーバがローカル接続に使用するUnix のソケット ファイル。

--timezone=timezone

TZ タイム ゾーンの環境変数を任意のオプション値に設定する。正規 (リーガル) のタイム ゾーン形式に関しては、オペレーティング システムのマニュアルを参照のこと。

--user={user_name|user_id}

mysqld サーバを、user_name (名前)、または user_id (数字のユーザ ID) を保有するユーザとして実行する。ここでの 「ユーザ」 は、権限テーブルにリストしている MySQL ユーザではなく、システム ログイン アカウントを指す）。

サーバとデータベースは作業中のディレクトリと関連する。つまり mysqld_safe から呼び出したディレクトリであること。バイナリ配布の場合、mysqld_safe は、bin と data のディレクトリにあり、ソース配布の場合は、libexec と var のディレクトリにある。この条件が一致していると、MySQL をインストールしたディレクトリから mysqld_safe を実行できる。たとえば、バイナリ配布の場合には、/usr/local/mysql である。

サーバとデータベースが作業中のディレクトリと関連しない場合は、mysqld_safe は絶対パスで探そうとする。通常は、/usr/local/libexec と /usr/local/var に位置する。実際の場所は、構築したとき設定した値で決定する。MySQL を設定時に指定の場所へインストールしていれば、正確に動作する。

--help

ヘルプメッセージを表示し、終了。

--config-file=file_name

代替オプション (設定) ファイル。これは、mysqld_multi が [mysqldN] オプション グループを探すときに影響する。このオプションがない場合、すべてのオプションは通常の my.cnf ファイルから読み取る。このオプションは、mysqld_multi が独自のオプションを読むときには影響しない。つまり常に、[mysqld_multi] グループを通常の my.cnf ファイルから読み取る。

--example

サンプルのオプション ファイルを表示する。

--log=file_name

ログ ファイルを指定する。このファイルが存在していれば、すべてがログ ファイルへの記録になる。

--mysqladmin=prog_name

サーバ停止 (シャットダウン) に使用する mysqladmin バイナリ。

--mysqld=prog_name

使用する mysqld バイナリ。ノート： このオプションに mysqld_safe を値として指定することもできる。mysqld_safe をサーバの起動に使用する場合は、[mysqldN] オプション グループに相当する mysqld または ledir などのオプションを含めることができる。これらのオプションは、mysqld_safe が起動するサーバの名前とサーバが置かれているディレクトリのパスを指す。(これらのオプションに関する説明は、項4.3.1. 「mysqld_safe ? MySQL サーバ スタートアップ スクリプト」 を参照のこと。) 次は例示。

[mysqld38]
mysqld = mysqld-debug
ledir  = /opt/local/mysql/libexec

--no-log

ログ ファイルではなく、stdout にログを書き込む。デフォルトはログ ファイルへの出力。

--password=password

mysqladmin を呼び出すときに使う MySQL アカウント ユーザのパスワード。ノート： MySQL プログラムの場合とは異なり、パスワード値はこのオプションではオプショナルではない。

--silent

サイレント モード、警告を無効にする。

--tcp-ip

MySQL サーバを TCP/IP ポートまたは Unix ソケット ファイルを経由して接続する。ソケット ファイルがない場合でも、サーバは実行可能であるが、TCP/IP ポートからだけアクセスできる。デフォルトでは、Unix ソケット ファイルを使用した接続。このオプションは stop と report の操作に影響する。

--user=user_name

mysqladmin を呼び出すときの MySQL アカウントのユーザ名。

--verbose

冗長にする。(出力をより詳細にする。)

--version

バージョン情報を表示して、終了する。

重要：mysqld_multi コマンドを使用する前には、mysqld サーバへ渡すオプションの意味と、なぜ、mysqld プロセスを区切る必要があるのかを十分に理解してください。同じデータ ディレクトリで複数の mysqld サーバを使用することには危険が伴います。これを複数のサーバを使用するときは、データ ディレクトリを別々に分けてください。同じデータ ディレクトリで複数のサーバを使用することが、スレッド システム のパフォーマンス改善にはなりません。項4.12. 「同じマシン上での複数 MySQL サーバの実行」 を参照してください。

重要 ：それぞれのサーバのデータ ディレクトリが Unix アカウントから完全にアクセスできるかどうかを確かめてください。このアカウントは特定の mysqld プロセスを起動するものです。これに、状況を完全に 理解していない場合は、Unix root アカウントを 使用しない でください。項4.6.5. 「ユーザによる MySQL の実行」 を参照してください。

mysqld サーバを (mysqladmin プログラムで) 終了するときに使用する MySQL アカウントが、それぞれのサーバで同一のユーザ名とパスワードであることを確かめてください。そのアカウントには SHUTDOWN 権限があることも確かめてください。管理するサーバで、管理アカウント用に異なるユーザ名とパスワードがにある場合は、それぞれのサーバで同一のユーザ名とパスワードのアカウントを作成してください。たとえば、共通の multi_admin アカウントをセットアップします。これには、次のコマンドをそれぞれのサーバで実行します。

shell> mysql -u root -S /tmp/mysql.sock -p
Enter password:
mysql> GRANT SHUTDOWN ON *.*
    -> TO 'multi_admin'@'localhost' IDENTIFIED BY 'multipass';

項4.7.2. 「権限システムの機能」 を参照してください。これは、それぞれの mysqld サーバで行ってください。それぞれにアクセスするときに、接続パラメータを適宜に変更します。ノート： アカウント名のホスト名の部分は、mysqld_multi を実行する所のホストから multi_admin として接続できるようにします。

Unix ソケット ファイルと TCP/IP ポート番号は、すべての mysqld とは異なる必要があります。

--pid-file オプションはとても重要です。たとえば、--mysqld=mysqld_safe などのように、mysqld を起動するときに mysqld_safe を使用している場合と特に重要です。どの mysqld コマンドにも独自のプロセス ID ファイルがあります。mysqld ではなく、mysqld_safe を使用するということには、mysqld_safe は mysqld のプロセスを監視しているため、kill -9 を使用したシグナル送信や、segmentation fault のようなことがあると、プロセスを終了し、再起動するという利点があります。mysqld_safe スクリプトは特定の場所から開始しなければならいことがあります。これは、mysqld_multi を実行する前に、特定のディレクトリに位置を変更しなけれならない可能性がある、ということです。起動時に問題がある場合は、 mysqld_safe スクリプトを調べ、特に次のラインをチェックください。

----------------------------------------------------------------
MY_PWD=`pwd`
# Check if we are starting this relative (for the binary release)
if test -d $MY_PWD/data/mysql -a \
   -f ./share/mysql/english/errmsg.sys -a \
   -x ./bin/mysqld
----------------------------------------------------------------

これらのラインでテストすると成功しますが、そうでない場合、つまり問題がある場合は、項4.3.1. 「mysqld_safe ? MySQL サーバ スタートアップ スクリプト」 を参照してください。

--user オプションを mysqld に使用する場合は、 Unix root ユーザで mysqld_multi スクリプトを実行する必要があります。このオプションがオプション ファイルにあるかどうかは問題ではなく、もしスーパーユーザではない人が、mysqld プロセスを Unix アカウントで立ち上げると、警告が出ます。

--help, -?

ヘルプ メッセージを表示し、終了。

--add-user

新規ユーザをパスワード ファイルに追加する。--username オプションで指定する。(MySQL 5.1.12 での追加)

--angel-pid-file=file_name

エンジェル プロセス (angel process) がプロセス ID に記録するファイル。mysqlmanager がデーモン モードで実行になるときのこと。(すなわち、--run-as-service オプションを与えた場合。) デフォルトのファイル名は mysqlmanager.angel.pid。

--angel-pid-file オプションを与えない場合、デフォルトのエンジェル PID ファイルは、PID ファイルと同じ名前。ただし、PID ファイルの拡張子は、.angel.pid の拡張子と置換。(例： mysqlmanager.pid は mysqlmanager.angel.pid となる。)

(MySQL 5.1.11 での追加)

--bind-address=IP

バインドする IP アドレス。

--check-password-file

パスワード ファイルの正当性 (validity) と整合性 (consistency) をチェックする。(MySQL 5.1.12 での追加)

--clean-password-file

パスワード ファイルからすべてのユーザをドロップする。(MySQL 5.1.12 での追加)

--debug=debug_options, -# debug_options

デバッグ ログを書き込む。debug_options 文字列は、'd:t:o,file_name' というのが通常。(MySQL 5.1.10 での追加)

--default-mysqld-path=path

MySQL Server バイナリのパス。このパスは、設定ファイルのサーバ インスタンス セクションすべてに使用する。この設定ファイルには mysqld-path オプションがない。デフォルトではコンパイル時のパス。これは、MySQL 配布がどのように設定されたかによる。次はその例。--default-mysqld-path=/usr/sbin/mysqld

--defaults-file=file_name

Instance Manager と MySQL Server のセッティングを任意のファイルから読み込む。Instance Manager による設定変更のすべてがこのファイルに書き込まれる。これを使用するときには、コマンドラインで最初のオプションにし、ファイルは存在している必要がある。

このオプションを使用しない場合、Instance Manager は標準の設定ファイルを使用する。Windows では、Instance Manager をインストールしたディレクトリの my.ini ファイル。Unix では、 /etc/my.cnf が標準ファイル。

--drop-user

新規ユーザをパスワード ファイルからドロップする。--username オプションで指定する。(MySQL 5.1.12 での追加)

--edit-user

パスワード ファイルの既存ユーザ エントリを変更する。--username オプションで指定する。(MySQL 5.1.12 での追加)

--install

Windows では、Instance Manager を Windows のサービスとしてインストールする。サービス名は MySQL Manager。

--list-users

パスワード ファイルのユーザをリストする。(MySQL 5.1.12 に追加)

--log=file_name

Instance Manager のログ ファイルのパス。--run-as-service オプションを与えない限り、このオプションの無効。このオプションで指定するファイル名が相対的である場合、ログ ファイルは Instance Manager を立ち上げたディレクトリ下での作成となる。特定のディレクトリで作成できたかどうかを確かめるには、これをフル パスで指す。

--run-as-service を --log なしで与えた場合、ログ ファイルはデータ ディレクトリの mysqlmanager.log になる。

--run-as-service を与えない場合、ログ メッセージは標準出力へ行く。ログ 出力を獲得するには、Instance Manager 出力をファイルにリダイレクトする。次はその例。

mysqlmanager > im.log

--monitoring-interval=seconds

サーバ インスタンス監視のインターバル (秒)。デフォルトでは、20 秒。Instance Manager は監視対象 (ガード) のインスタンスのそれぞれとの接続を試行するときに、存在していない MySQL_Instance_Manager ユーザ アカウントを使用して、バイタルがあるかどうかをチェックする。接続試行の結果がインスタンスにバイタルがないことを示す場合、Instance Manager はインスタンスを再起動する前に、この試行を何度か実行する。

通常、MySQL_Instance_Manager アカウントは存在しないため、Instance Manager の接続試行は、監視しているインスタンスから次のようなメッセージをクエリ ログに生成する。

Access denied for user 'MySQL_Instance_M'@'localhost' ≫
    (using password: YES)

適切なサーバ インスタンス セクションにある nonguarded オプションが特定のインスタンス監視を無効にする。起動してからインスタンスが動かない場合は、Instance Manager はそれを再起動しません。SHOW INSTANCES などで、インスタンスのステータスを要求しない限り、Instance Manager はガードなしのインスタンスとの接続を試行します。

詳細は、項4.4.5. 「MySQL サーバ インスタンス ステータスの監視」を参照してください。

--mysqld-safe-compatible

mysqld_safe に準拠するマナーで実行。詳細は、項4.4.3. 「MySQL Instance Manager で MySQL Server の起動」 を参照してください。(MySQL 5.1.12 での追加)

--password=password, -p password

パスワード ファイルに、エントリを追加する、また変更するときのパスワードを指定する。これまでの MySQL プログラムの--password/-P オプションとは異なり、パスワードは必須です。オプションではありません。(MySQL 5.1.12 での追加)

--password-file=file_name

Instance Manager がユーザとパスワードを探すファイルの名前。Windows では、 Instance Manager をインストールしたディレクトリの mysqlmanager.passwd がデフォルト。Unix では、/etc/mysqlmanager.passwd がデフォルト ファイル。

--pid-file=file_name

プロセス ID ファイル。Windows では Instance Manager をインストールしたディレクトリの mysqlmanager.pid ファイルがデフォルト。Unix では、データ ディレクトリの mysqlmanager.pid がデフォルト。

--port=port_num

クライアントからのTCP/IP 接続に使用するポート番号。デフォルトのポート番号は、IANA 割り当ての 2273。

--print-defaults

現在のデフォルトを出力し、終了。このオプションを使用するときは、コマンドラインの最初に置く。

--print-password-line

パスワード ファイルへのエントリを準備し、標準出力を表示し、終了する。Instance Manager の出力をファイルへリダイレクトして、そのファイルに保存できる。

MySQL 5.1.12 前のこのオプションの旧称は --passwd である。

--remove

Windows 環境で、Windows サービスとしての Instance Manager を取り除く。これは、Instance Manager が以前に --install オプションで稼動していたことを前提とする。

--run-as-service

Unix 環境で、デーモン化して、エンジェル プロセスを開始する。エンジェル プロセスは Instance Manager を監視し、クラッシュしたときに、再起動する。エンジェル プロセス自体はシンプルで、クラッシュすることはあまりない。

--socket=path

Unix 環境で、着信する接続に使用するソケット ファイル。デフォルトは /tmp/mysqlmanager.sock 。このオプションは Windows では無意味。

--standalone

Windows で、Instance Manager をスタンド アローン型として稼動するときに使用する。これを指定するときは、Instance Manager をコマンドラインから立ち上げる。

--user=user_name

Unix 環境で、mysqlmanager コマンドを起動実行するときに使用するシステム アカウントのユーザ名。このオプションは警告を出すが、root または名前をつけたユーザで mysqlmanager を立ち上げる場合 (有効なユーザ ID に変更する) を除いて、効果がない。mysqld サーバを実行するときと同じアカウントを使用している場合に、mysqlmanager を組み込むことを推奨。(ここの 「ユーザ」 とは、システム ログインのときのアカウントのことで、権限テーブルの MySQL ユーザのことではない。)

--username=user_name, -u user_name

パスワード ファイルに追加または変更するエントリのユーザ名を指定する。(MySQL 5.1.12 に追加)

--version, -V

バージョン情報を表示して、終了する。

--wait-timeout=N

着信 (incoming) 接続でのアクティビティを閉じる前に待機する秒数。デフォルトでは 28800 秒 (8 時間)。

MySQL 5.1.7 で追加した。以前は、このタイムアウトは 30 秒で、変更不可だった。

mysqld-path = path

mysqld サーバ バイナリのパス。サーバ インスタンスに使用する。

nonguarded

このオプションは、サーバ インスタンスに対する Instance Manager の監視機能を無効化する。デフォルトでは、インスタンスをガードしています。Instance Manager の起動時に、インスタンスも起動する。インスタンス ステータスを監視し、失敗したときは再起動を試行する。Instance Manager の終了時には、インスタンスを停止します。ガードなしのインスタンスの場合には、これらの動作はない。

shutdown-delay = seconds

Instance Manager がシステム終了する前に、サーバ インスタンスを待機する秒数。デフォルトは 35 秒。この待機値を超えると、 Instance Manager は、インスタンスにバイタルがないとみなし、システム終了を試行する。大きなテーブルで InnoDB を使用している場合、この値を大きくする。

新オプション： --mysqld-safe-compatible、MySQL 5.1.12 以前と同様に起動時の動作を Instance Manager にさせる。Instance Manager は [mysqld] インスタンス セクションを設定ファイルで検索し、起動する。Instance Manager が [mysqld] セクションを見つけることができない場合、設定ファイルにアクセス可能であれば、新たに デフォルトの設定値で[mysqld] セクションを書き込む。そして mysqld インスタンスを起動する。Instance Manager は設定ファイル内の別のガード付きインスタンスを立ち上げることもできる。

--mysqld-safe-compatible がない場合、Instance Manager はその設定ファイルを読み、ファイルがあれば、そのファイルのガード付きインスタンス セクションでインスタンスを起動する。ファイルがない場合、インスタンスを起動できない。

MySQL Server アカウントは、ホスト名、ユーザ名、パスワード。 (項4.8.1. 「MySQL ユーザ名とパスワード」 を参照のこと。)

Instance Manager はユーザ名とパスワードだけ。

新規ユーザの作成

mysqlmanager --add-user --username=user_name [--password=password]

任意のユーザ名とパスワードをパスワード ファイルに新たなエントリとして加える。--username (または -u) オプション が必要。mysqlmanager でパスワードを指し、これは、--password (または -p) のコマンドラインで与えていないパスワードのこと。ユーザが既に存在していれば、追加できない。

既存ユーザの削除

mysqlmanager --drop-user --username=user_name

パスワード ファイルのユーザ名のエントリを削除する。ユーザ名が必要。ユーザが存在しなければ、削除できない。

既存ユーザのパスワード変更

mysqlmanager --edit-user --username=user_name [--password=password]

パスワード ファイルのユーザのパスワードを削除する。ユーザ名が必要。コマンドラインを使用しない場合は、mysqlmanager で呼び出す。ユーザが存在しなければ、変更できない。

既存ユーザのリスト

mysqlmanager --list-users

このコマンドで、パスワード ファイルのアカウント ユーザ名をリストする。

パスワード ファイルのチェック

mysqlmanager --check-password-file

このコマンドで、パスワード ファイルの整合性と妥当性チェックを行う。このコマンドの失敗は、ファイルに異常があることを示す。

パスワード ファイルの空化

mysqlmanager --clean-password-file

パスワード ファイルを空にする。ファイルにリストされているすべてのユーザを削除する。パスワード ファイルが存在しない場合、このオプションで作成。つまり、このオプションは、別の account-management 操作で使用する新しいパスワード ファイルを作成する。誤ってアカウントを削除しないように、このオプションを使用するときは注意が必要。

インスタンス名が有効でない場合、動作しない。

インスタンス名が無い (存在しない) 場合、動作しない。 (CREATE INSTANCE は別。)

インスタンスが適切なステート (状態) であるよう要求する。オフラインではないインスタンスを設定または起動することはできない。 (MySQL 5.1.12 以降)

ファイルが存在しない、または Instance Manager からアクセスできない場合は、設定ファイルの変更はできない。Instance Manager では、内部キャッシュ (メモリ) でインスタンス設定 (コンフィギュレーション) に関する情報を保管している。基本的には、設定ファイルが存在すれば、情報はそこから送られ、コマンドによってはインスタンスの設定を変更できる。

コマンドで、内部キャッシュ とサーバの設定ファイルのインスタンス セクションの整合性を維持するために、両方を変更 (修正) する。(MySQL 5.1.12 以降。) これを行うには、まずインスタンスがオフラインであること、設定ファイルがアクセス可能であり、不正形式ではないことを確認する。設定ファイルを更新できない場合に、コマンドに失敗すると、キャッシュへの変更がないままとなる。

Windows 環境では、 Instance Manager をインストールした ディレクトリの my.ini が標準ファイル。Unix 環境では、/etc/my.cnf が標準の設定ファイル。異なる設定ファイルを指定するには、--defaults-file オプションで Instance Manager を起動する。