PDF (US Ltr)
- 26.8Mb
PDF (A4)
- 26.9Mb
HTML Download (TGZ)
- 7.1Mb
HTML Download (Zip)
- 7.2Mb
mysqld サーバーを起動するときに、セクション4.2.3「プログラムオプションの指定」に記載されているいずれかの方法で、プログラムオプションを指定できます。もっとも一般的な方法は、オプションファイルまたはコマンド行でオプションを提供するやり方です。ただし、ほとんどの場合では、サーバーが毎回実行するときサーバーが必ず同じオプションを使用します。これを確実に行う最適な方法は、オプションファイルにオプションを一覧表示することです。セクション4.2.6「オプションファイルの使用」を参照してください。このセクションではオプションファイルの形式および構文についても説明します。
mysqld は [mysqld] および [server] グループからオプションを読み取ります。mysqld_safe は [mysqld]、[server]、[mysqld_safe]、および [safe_mysqld] グループからオプションを読み取ります。mysql.server は [mysqld] および [mysql.server] グループからオプションを読み取ります。
Embedded MySQL Server は通常、[server]、[embedded]、および [ グループからオプションを読み取り、ここで xxxxx_SERVER]xxxxx はこのサーバーを組み込んでいるアプリケーション名です。
mysqld には多くのコマンドオプションがあります。簡単なサマリーについては、mysqld --help を実行します。完全なリストを表示するには、mysqld --verbose --help を使用します。
次に、もっとも一般的なサーバーオプションの一部を示します。その他のオプションは、ほかのセクションに記載されています。
セキュリティーに影響するオプション。セクション6.1.4「セキュリティー関連の mysqld オプションおよび変数」を参照してください。
SSL 関連オプション。セクション6.3.10.4「SSL コマンドのオプション」を参照してください。
バイナリログ制御オプション。セクション5.2.4「バイナリログ」を参照してください。
レプリケーション関連オプション。セクション17.1.4「レプリケーションおよびバイナリロギングのオプションと変数」を参照してください。
プラガブルストレージエンジンなどのプラグインをロードするためのオプション。セクション5.1.8.1「プラグインのインストールおよびアンインストール」を参照してください。
特定のストレージエンジンに固有のオプション。セクション14.12「InnoDB の起動オプションおよびシステム変数」およびセクション15.2.1「MyISAM 起動オプション」を参照してください。
また、このセクションの最後に記載されているように、サーバーシステム変数の値を設定するとき、変数名をオプションとして使用することもできます。
一部のオプションはバッファーまたはキャッシュのサイズを制御します。所定のバッファーについて、サーバーは内部データ構造を割り当てる必要がある場合もあります。これらの構造は、バッファーに割り当てられた合計メモリーから割り当てられ、必要なスペースの量はプラットフォームに依存することがあります。つまり、バッファーサイズを制御するオプションに値を割り当てたとき、実際に使用可能なスペースの量が、割り当てられた値と異なる場合もあることを意味します。一部の場合では、この量は割り当てられた値より少ないこともあります。また、サーバーが値を上方に調整することも考えられます。たとえば、最小値が 1024 のオプションに値 0 を割り当てた場合、サーバーは値を 1024 に設定します。
バッファーサイズ、長さ、およびスタックサイズの値は、別途指定しないかぎりバイト単位で指定されます。
一部のオプションはファイル名の値を取ります。別途指定しないかぎり、値が相対パス名であれば、デフォルトのファイルの場所はデータディレクトリです。場所を明示的に指定するには、絶対パス名を使用します。たとえばデータディレクトリが /var/mysql/data だとします。ファイル値のオプションが相対パス名として指定された場合、ファイルは /var/mysql/data の下に配置されます。値が絶対パス名である場合、その場所はパス名によって指定されます。
-
Property Value コマンド行形式 --help短いヘルプメッセージを表示して終了します。詳細メッセージを表示するには、
--verboseおよび--helpの両方のオプションを使用します。 -
Property Value コマンド行形式 --allow-suspicious-udfs型 ブール デフォルト FALSEこのオプションは、メイン関数に
xxx記号のみを持つユーザー定義関数をロードできるかどうかを制御します。デフォルトでは、このオプションはオフで、少なくとも 1 つの補助記号を持つ UDF のみをロードできます。これにより、正当な UDF を含むもの以外の共有オブジェクトファイルから関数をロードしないようにします。セクション24.3.2.6「ユーザー定義関数のセキュリティー上の予防措置」を参照してください。 -
Property Value コマンド行形式 --ansiMySQL 構文の代わりに標準 (ANSI) SQL 構文を使用します。サーバー SQL モードをさらに正確に制御するには、代わりに
--sql-modeオプションを使用します。セクション1.7「MySQL の標準への準拠」、セクション5.1.7「サーバー SQL モード」を参照してください。 -
Property Value コマンド行形式 --basedir=pathシステム変数 basedirスコープ グローバル 動的 いいえ 型 ディレクトリ名 MySQL インストールディレクトリへのパス。すべてのパスは、通常はこのディレクトリを基準として解決されます。
-
Property Value コマンド行形式 --big-tablesシステム変数 big_tablesスコープ グローバル、セッション 動的 はい 型 ブール デフォルト OFFすべての一時的セットをファイルに保存することによって、大きい結果セットを有効にします。このオプションによって、ほとんどの 「table full」 エラーを防ぎますが、インメモリーテーブルだけで十分なクエリーの速度が低下します。MySQL 3.23.2 以降では、サーバーは小さい一時テーブルについてはメモリーを使用し、必要な場合にディスクテーブルに切り換えることによって、大きい結果セットを自動的に処理できます。
-
Property Value コマンド行形式 --bind-address=addrシステム変数 (>= 5.6.1) bind_addressスコープ (>= 5.6.1) グローバル 動的 (>= 5.6.1) いいえ 型 文字列 デフォルト (>= 5.6.6) *デフォルト (<= 5.6.5) 0.0.0.0MySQL Server は、TCP/IP 接続について単一ネットワークソケットを listen します。このソケットは単一アドレスにバインドされますが、あるアドレスを複数のネットワークインタフェースにマップできます。アドレスを指定するには、サーバー起動時に
--bind-address=オプションを使用します。ここで、addraddrは IPv4 または IPv6 アドレスあるいはホスト名です。addrがホスト名の場合、サーバーはこの名前を IP アドレスに解決し、そのアドレスにバインドします。サーバーはさまざまなタイプのアドレスを次のように処理します。
アドレスが
*の場合、サーバーホストが IPv6 アドレスをサポートする場合はすべてのサーバーホストの IPv6 および IPv4 インタフェース上の TCP/IP 接続を受け入れ、そうでない場合はすべての IPv4 アドレスの TCP/IP 接続を受け入れます。すべてのサーバーインタフェース上の IPv4 および IPv6 の両方の接続を許可するには、このアドレスを使用します。この値は、MySQL 5.6.6 以降で許可されています (またデフォルトです)。アドレスが
0.0.0.0の場合、サーバーはすべてのサーバーホスト IPv4 インタフェース上の TCP/IP 接続を受け入れます。これは MySQL 5.6.6 以前のデフォルトです。アドレスが
::の場合、サーバーはすべてのサーバーホスト IPv4 および IPv6 インタフェース上の TCP/IP 接続を受け入れます。アドレスが IPv4 にマップ済みのアドレスの場合、サーバーは IPv4 または IPv6 のいずれかの形式で、そのアドレスの TCP/IP 接続を受け入れます。たとえば、サーバーが
::ffff:127.0.0.1にバインドされている場合、クライアントは--host=127.0.0.1または--host=::ffff:127.0.0.1のいずれかを使用して接続できます。アドレスが「通常の」 IPv4 または IPv6 アドレスの場合 (
127.0.0.1や::1など)、サーバーはその IPv4 または IPv6 アドレスについてのみ TCP/IP 接続を受け入れます。
サーバーを特定のアドレスにバインドする予定の場合、そのアドレスに接続するために使用できる管理者権限を持つアカウントが
mysql.user付与テーブルに含まれていることを確認します。そうでない場合、サーバーをシャットダウンできません。たとえば、サーバーを*にバインドしている場合、すべての既存のアカウントを使用して接続できます。ただし、サーバーを::1にバインドしている場合、そのアドレスの接続のみ受け入れます。この場合、'root'@'::1'アカウントがmysql.userテーブルに存在することをまず確認して、サーバーに接続してシャットダウンできることをたしかめます。 -
--binlog-format={ROW|STATEMENT|MIXED}Property Value コマンド行形式 --binlog-format=formatシステム変数 binlog_formatスコープ グローバル、セッション 動的 はい 型 列挙 デフォルト (>= 5.6.10-ndb-7.3.1) MIXEDデフォルト STATEMENT有効な値 ROWSTATEMENTMIXED行ベース、ステートメントベース、または複合型のレプリケーションのいずれを使用するか指定します。ステートメントベースは MySQL 5.6 のデフォルトです。セクション17.1.2「レプリケーション形式」を参照してください。
一部の状況では、この変数を実行時に変更できなかったり、レプリケーションの失敗の原因になったりします。詳細については、セクション5.2.4.2「バイナリログ形式の設定」を参照してください。
バイナリロギングを有効にしないでバイナリロギング形式を設定すると、
binlog_formatグローバルシステム変数が設定されて、警告がログに記録されます。 -
Property Value コマンド行形式 --bootstrapこのオプションは、MySQL Server 全体を開始させることなく MySQL 特権テーブルを作成するために、mysql_install_db プログラムによって使用されます。
MySQL 5.6.6 以降では、このオプションが使用されるとレプリケーションおよびグローバルトランザクション ID が常に自動的に無効化されます (バグ #1332602)。セクション17.1.3「グローバルトランザクション識別子を使用したレプリケーション」を参照してください。
-
Property Value コマンド行形式 --character-sets-dir=pathシステム変数 character_sets_dirスコープ グローバル 動的 いいえ 型 ディレクトリ名 文字セットがインストールされているディレクトリ。セクション10.5「文字セットの構成」を参照してください。
-
--character-set-client-handshakeProperty Value コマンド行形式 --character-set-client-handshake型 ブール デフォルト TRUEクライアントによって送信された文字セット情報を無視しません。クライアント情報を無視して、サーバーのデフォルトの文字セットを使用するには、
--skip-character-set-client-handshakeを使用します。これにより、MySQL は MySQL 4.0. のように動作します。 -
--character-set-filesystem=charset_nameProperty Value コマンド行形式 --character-set-filesystem=nameシステム変数 character_set_filesystemスコープ グローバル、セッション 動的 はい 型 文字列 デフォルト binaryファイルシステムの文字セット。このオプションは、
character_set_filesystemのシステム変数を設定します。 -
--character-set-server=,charset_name-Ccharset_nameProperty Value コマンド行形式 --character-set-serverシステム変数 character_set_serverスコープ グローバル、セッション 動的 はい 型 文字列 デフォルト latin1charset_nameをデフォルトの文字セットとして使用します。セクション10.5「文字セットの構成」を参照してください。このオプションを使用してデフォルト以外の文字セットを指定する場合、照合順序を指定するために--collation-serverも使用します。 -
Property Value コマンド行形式 --chroot=dir_name型 ディレクトリ名 chroot()のシステムコールを使用して、mysqld サーバーを起動中にクローズ環境にします。これは推奨されるセキュリティー対策です。このオプションを使用すると、LOAD DATA INFILEおよびSELECT ... INTO OUTFILEがいくらか制限されることに注意してください。 -
--collation-server=collation_nameProperty Value コマンド行形式 --collation-serverシステム変数 collation_serverスコープ グローバル、セッション 動的 はい 型 文字列 デフォルト latin1_swedish_cicollation_nameをサーバーのデフォルトの照合順序として使用します。セクション10.5「文字セットの構成」を参照してください。 -
Property Value コマンド行形式 --consoleプラットフォーム固有 Windows (Windows のみ。)このオプションが使用されている場合、エラーログメッセージを
stderrに書き込み、stdout. mysqld はコンソールウィンドウを閉じません。--log-errorおよび--consoleの両方が指定されている場合、--log-errorが優先されます。サーバーはログファイルに書き込みますが、コンソールには書き込みません。 -
Property Value コマンド行形式 --core-file型 ブール デフォルト OFFmysqld が異常終了した場合にコアファイルを作成します。コアファイルの名前および場所はシステムに依存します。Linux の場合、
core.という名前のコアファイルがプロセスの現在の作業ディレクトリに書き込まれ、これは mysqld のデータディレクトリです。pidpidはサーバープロセスのプロセス ID を表します。OS X の場合、core.という名前のコアファイルがpid/coresディレクトリに書き込まれます。Solaris の場合、coreadm コマンドを使用して、コアファイルの書き込み先と名前を指定する方法を指定します。一部のシステムでコアファイルを取得するには、mysqld_safe に
--core-file-sizeオプションを指定する必要もあります。セクション4.3.2「mysqld_safe — MySQL サーバー起動スクリプト」を参照してください。Solaris などの一部のシステムでは、--userオプションも使用しないとコアファイルを取得できません。追加の制限または制約がある場合もあります。たとえば、サーバーを起動する前に ulimit -c unlimited を実行することが必要な場合もあります。システムのドキュメントを参照してください。 -
Property Value コマンド行形式 --datadir=pathシステム変数 datadirスコープ グローバル 動的 いいえ 型 ディレクトリ名 データディレクトリへのパス。
-
--debug[=,debug_options]-# [debug_options]Property Value コマンド行形式 --debug[=debug_options]システム変数 debugスコープ グローバル、セッション 動的 はい 型 文字列 デフォルト (Windows) d:t:i:O,\mysqld.traceデフォルト (Unix) d:t:i:o,/tmp/mysqld.traceMySQL が
-DWITH_DEBUG=1で構成されている場合、このオプションを使用して、mysqld の動作のトレースファイルを取得できます。一般的なdebug_options文字列はd:t:o,です。デフォルトは、UNIX の場合はfile_named:t:i:o,/tmp/mysqld.trace、Windows の場合はd:t:i:O,\mysqld.traceです。-DWITH_DEBUG=1を使用して MySQL にデバッグサポートを構成することにより、サーバーを起動するときに--debug="d,parser_debug"オプションを使用できるようになります。これにより、SQL ステートメントの処理に使用される Bison パーサーが、パーサートレースをサーバーの標準エラー出力にダンプします。一般的に、この出力はエラーログに書き込まれます。このオプションは複数回指定されることがあります。
+または-で開始される値が以前の値に加算または減算されます。たとえば、--debug=T--debug=+Pと指定すると、値はP:Tに設定されます。詳細については、セクション24.4.3「DBUG パッケージ」を参照してください。
-
Property Value コマンド行形式 --debug-sync-timeout[=#]型 数値 テストおよびデバッグのための Debug Sync 機能が有効かどうかを制御します。Debug Sync を使用するには MySQL が
-DENABLE_DEBUG_SYNC=1オプションで構成されている必要があります (セクション2.9.4「MySQL ソース構成オプション」を参照)。Debug Sync がコンパイルされていない場合、このオプションは使用できません。オプション値は秒単位のタイムアウトです。デフォルト値は 0 で、Debug Sync を無効にします。これを有効にするには、0 より大きい値を指定してください。この値は、個々の同期点についてのデフォルトのタイムアウトになります。オプションが値なしで指定された場合、タイムアウトは 300 秒に設定されます。Debug Sync 機能および同期点の使用方法についての説明は、「MySQL Internals: Test Synchronization」を参照してください。
-
--default-authentication-plugin=plugin_nameProperty Value コマンド行形式 --default-authentication-plugin=plugin_name導入 5.6.6 型 列挙 デフォルト mysql_native_password有効な値 mysql_native_passwordsha256_passwordこのオプションは、デフォルトの認証プラグインを設定します。許可される値は
mysql_native_password(MySQL ネイティブパスワードを使用する) およびsha256_password(SHA-256 パスワードを使用する) です。これらのプラグインについての詳細は、セクション6.3.8.1「ネイティブ認証プラグイン」およびセクション6.3.8.4「SHA-256 認証プラグイン」を参照してください。このオプションは MySQL 5.6.6 で追加されました。注記MySQL 5.6.17 以前でこのオプションを使用して、デフォルトの認証プラグインを
mysql_native_password以外の値に変更した場合、MySQL 5.5.7 より古いクライアントは認証プロトコルへの変更の結果を認識できないため接続できなくなります。--default-authentication-plugin値は、サーバー操作の次の側面に影響します。プラグインの名前を
IDENTIFIED WITH句で明示的に指定しないCREATE USERおよびGRANTステートメントによって作成された新規アカウントに対して、サーバーが割り当てる認証プラグインを決定します。起動時に
old_passwordsシステム変数を、デフォルトプラグインによって必要となるパスワードハッシュ方式と整合性のある値に設定します。old_passwords値は、CREATE USERおよびGRANTのIDENTIFIED BY句で指定されたパスワードのハッシュと、PASSWORD()関数の引数として指定されるパスワードに影響します。-
次のいずれかのステートメントで作成されるアカウントについて、サーバーはアカウントにデフォルト認証プラグインを関連付け、
old_passwordsの値によってハッシュされた所定のパスワードをアカウントに割り当てます。CREATE USER ... IDENTIFIED BY 'cleartext password'; GRANT ... IDENTIFIED BY 'cleartext password'; -
次のいずれかのステートメントで作成されるアカウントについて、デフォルト認証プラグインで必要なハッシュ形式を使用してパスワードハッシュが暗号化されていない場合、ステートメントは失敗します。そうでない場合、サーバーはアカウントにデフォルト認証プラグインを関連付け、アカウントに所定のパスワードハッシュを割り当てます。
CREATE USER ... IDENTIFIED BY PASSWORD 'encrypted password'; GRANT ... IDENTIFIED BY PASSWORD 'encrypted password';
-
Property Value コマンド行形式 --default-storage-engine=nameシステム変数 default_storage_engineスコープ グローバル、セッション 動的 はい 型 列挙 デフォルト InnoDBテーブルのデフォルトストレージエンジンを設定します。第15章「代替ストレージエンジン」を参照してください。MySQL 5.6.3 以降では、このオプションは永続的なテーブルについてのみストレージエンジンを設定します。
TEMPORARYテーブルについてストレージエンジンを設定するには、default_tmp_storage_engineシステム変数を設定します。サーバー起動時のデフォルトストレージエンジンを無効にした場合、永続テーブルと
TEMPORARYテーブルの両方のデフォルトエンジンを別のエンジンに設定しなければならず、そうしないとサーバーは起動しません。 -
Property Value コマンド行形式 --default-time-zone=name型 文字列 デフォルトのサーバータイムゾーンを設定します。このオプションは、グローバルな
time_zoneシステム変数を設定します。このオプションを指定しない場合、デフォルトのタイムゾーンは、(system_time_zoneシステム変数の値によって指定される) システムのタイムゾーンと同一になります。 -
--defaults-extra-file=file_nameこのオプションファイルは、グローバルオプションファイルのあとに読み取りますが、(UNIX では) ユーザーオプションファイルの前に読み取るようにしてください。ファイルが存在しないかアクセスできない場合、エラーが発生します。
file_nameは、フルパス名でなく相対パス名として指定された場合、現行ディレクトリを基準にして解釈されます。 -
指定されたオプションファイルのみ使用します。ファイルが存在しないかアクセスできない場合、エラーが発生します。
file_nameは、フルパス名でなく相対パス名として指定された場合、現行ディレクトリを基準にして解釈されます。 -
通常のオプショングループだけでなく、通常の名前に
strのサフィクスが付いたグループも読み取ります。たとえば、mysqld は通常[mysqld]グループを読み取ります。--defaults-group-suffix=_otherオプションを指定した場合、mysqld は[mysqld_other]グループも読み取ります。 -
--delay-key-write[={OFF|ON|ALL}]Property Value コマンド行形式 --delay-key-write[=name]システム変数 delay_key_writeスコープ グローバル 動的 はい 型 列挙 デフォルト ON有効な値 ONOFFALL鍵の遅延書き込みを使用する方法を指定します。鍵の遅延書き込みにより、
MyISAMテーブルについて、書き込みと書き込みの間に鍵バッファーがフラッシュされなくなります。OFFは、鍵の遅延書き込みを無効にします。ONは、DELAY_KEY_WRITEオプションを付けて作成されたテーブルに対して鍵の遅延書き込みを有効にします。ALLは、すべてのMyISAMテーブルに対する鍵の書き込みを遅延させます。セクション8.11.2「サーバーパラメータのチューニング」およびセクション15.2.1「MyISAM 起動オプション」を参照してください。注記この変数を
ALLに設定した場合、MyISAMテーブルの使用中に、このテーブルを別のプログラム内 (別の MySQL Server または myisamchk など) から使用しないでください。これを行うと、インデックスが破損します。 -
Property Value コマンド行形式 --des-key-file=file_nameこのファイルからデフォルトの DES 鍵を読み取ります。これらの鍵は、
DES_ENCRYPT()およびDES_DECRYPT()関数によって使用されます。 -
Property Value コマンド行形式 --enable-named-pipeプラットフォーム固有 Windows 名前付きパイプのサポートを有効にします。このオプションは Windows にのみ適用されます。
-
--engine-condition-pushdown={ON|OFF}Property Value コマンド行形式 --engine-condition-pushdown非推奨 はい (removed in 5.6.1); use optimizer_switchシステム変数 engine_condition_pushdownスコープ グローバル、セッション 動的 はい 型 ブール デフォルト ON以前は、このオプションは
engine_condition_pushdownシステム変数を設定しており、このオプションおよび変数は MySQL 5.6.1 で両方とも削除されました。詳細については、セクション8.2.1.5「エンジンコンディションプッシュダウンの最適化」を参照してください。 -
Property Value コマンド行形式 --event-scheduler[=value]システム変数 event_schedulerスコープ グローバル 動的 はい 型 列挙 デフォルト OFF有効な値 ONOFFDISABLEDイベントスケジューラを有効または無効にし、開始または停止します。
詳細情報については、
--event-schedulerオプションを参照してください。 -
--exit-info[=,flags]-T [flags]Property Value コマンド行形式 --exit-info[=flags]型 数値 mysqld サーバーのデバッグに使用できる、複数の異なるフラグのビットマスクです。このオプションを使用するには、完全にこのオプションを理解していることが必要です。
-
Property Value コマンド行形式 --external-locking型 ブール デフォルト FALSEMySQL 4.0 以降ではデフォルトで無効になった、外部ロック (システムロック) を有効にします。
lockdが完全には機能しないシステム (Linux など) でこのオプションを使用すると、mysqld がデッドロックしやすくなることに注意してください。外部ロックを明示的に無効にするには、
--skip-external-lockingを使用します。外部ロックは
MyISAMテーブルアクセスにのみ影響します。使用できるまたはできない状況も含めた詳細情報については、セクション8.10.5「外部ロック」を参照してください。 -
Property Value コマンド行形式 --flushシステム変数 flushスコープ グローバル 動的 はい 型 ブール デフォルト OFF各 SQL ステートメント後にすべての変更内容をディスクにフラッシュ (同期) します。通常、MySQL では各 SQL ステートメントの終了後にのみすべての変更内容をディスクに書き込み、ディスクへの同期はオペレーティングシステムが処理します。セクションB.5.4.2「MySQL が繰り返しクラッシュする場合の対処方法」を参照してください。
-
Property Value コマンド行形式 --gdb型 ブール デフォルト FALSESIGINT用の割り込みハンドラ (ブレークポイントを設定するための^Cを使用して mysqld を停止するために必要) をインストールし、スタックトレースおよびコアファイルの処理を無効にします。セクション24.4「MySQL のデバッグおよび移植」 を参照してください。 -
Property Value コマンド行形式 --general-logシステム変数 general_logスコープ グローバル 動的 はい 型 ブール デフォルト OFF一般的なクエリーログの初期状態を指定します。引数がないか引数が 1 の場合、
--general-logオプションはログを使用可能にします。省略されるか引数が 0 の場合、オプションはログを使用不可にします。 -
Property Value コマンド行形式 --ignore-db-dir導入 5.6.3 型 ディレクトリ名 このオプションは、
SHOW DATABASESステートメントまたはINFORMATION_SCHEMAテーブルの特定のディレクトリ名を無視するようサーバーに指示します。たとえば、MySQL 構成によって、UNIX のファイルシステムのルートにデータディレクトリが指定された場合、システムはその場所に、サーバーが無視するlost+foundディレクトリを作成することがあります。--ignore-db-dir=lost+foundを指定してサーバーを起動すると、その名前はデータベースとしてリストされません。複数の名前を指定するには、このオプションをそれぞれの名前に 1 回ずつ複数回使用します。空の値を使用してオプションを指定すると (つまり、
--ignore-db-dir=) ディレクトリリストが空のリストにリセットされます。サーバー起動時に指定されるこのオプションのインスタンスは、
ignore_db_dirsシステム変数を設定するために使用されます。このオプションは MySQL 5.6.3 で追加されました。
-
Property Value コマンド行形式 --init-file=file_nameシステム変数 init_fileスコープ グローバル 動的 いいえ 型 ファイル名 起動時にこのファイルから SQL ステートメントを読み取ります。各ステートメントは単一の行にして、コメントを含めなでください。
-
--innodb-xxxInnoDBストレージエンジンのオプションを設定します。InnoDBオプションは、セクション14.12「InnoDB の起動オプションおよびシステム変数」にリストされています。 -
Property Value コマンド行形式 --install [service_name]プラットフォーム固有 Windows (Windows のみ) Windows の起動時に自動的に開始する Windows サービスとしてサーバーをインストールします。
service_nameの値が指定されない場合、デフォルトサービス名はMySQLです。詳細については、セクション2.3.5.7「Windows のサービスとして MySQL を起動する」を参照してください。注記--defaults-fileオプションおよび--installオプションを使用してサーバーを起動する場合、--installを先にする必要があります。 -
--install-manual [service_name]Property Value コマンド行形式 --install-manual [service_name]プラットフォーム固有 Windows (Windows のみ) 手動で開始する必要がある Windows サービスとしてサーバーをインストールします。Windows の起動中に自動的に開始されません。
service_nameの値が指定されない場合、デフォルトサービス名はMySQLです。詳細については、セクション2.3.5.7「Windows のサービスとして MySQL を起動する」を参照してください。注記--defaults-fileオプションおよび--install-manualオプションを使用してサーバーを起動する場合、--install-manualを先にする必要があります。 -
--language=lang_name, -Llang_nameProperty Value コマンド行形式 --language=name非推奨 5.6.1; use lc-messages-dirシステム変数 languageスコープ グローバル 動的 いいえ 型 ディレクトリ名 デフォルト /usr/local/mysql/share/mysql/english/エラーメッセージに使用する言語。
lang_nameは、言語名として指定するか、言語ファイルがインストールされているディレクトリへのフルパス名として指定できます。セクション10.2「エラーメッセージ言語の設定」を参照してください。MySQL 5.6 では、
--lc-messages-dirおよび--lc-messagesを使用し、--languageは使用しないでください。こちらは MySQL 5.6.1 で非推奨となり、--lc-messages-dirのエイリアスとして処理されます。--languageオプションは今後の MySQL リリースで削除されます。 -
Property Value コマンド行形式 --large-pagesシステム変数 large_pagesスコープ グローバル 動的 いいえ プラットフォーム固有 Linux 型 ブール デフォルト FALSEハードウェアまたはオペレーティングシステムのアーキテクチャーによっては、デフォルト (通常は 4K バイト) よりも大きいメモリーページをサポートしています。このサポートの実際の実装は、ベースとなるハードウェアやオペレーティングシステムに依存します。大量のメモリーアクセスがあるアプリケーションの場合、大きいページを使用して、トランスレーションルックアサイドバッファー (TLB; Translation Lookaside Buffer) のミスが減ることによってパフォーマンスが改善される可能性があります。
MySQL 5.6 は、大きいページのサポートの Linux 実装 (Linux では HugeTLB と呼ばれる) をサポートします。セクション8.11.4.2「ラージページのサポートの有効化」を参照してください。大きいページの Solaris サポートについては、
--super-large-pagesオプションの説明を参照してください。--large-pagesはデフォルトで無効になっています。 -
Property Value コマンド行形式 --lc-messages=nameシステム変数 lc_messagesスコープ グローバル、セッション 動的 はい 型 文字列 デフォルト en_USエラーメッセージに使用するロケール。デフォルトは
en_USです。サーバーは引数を言語名に変換し、これを--lc-messages-dirの値と組み合わせてエラーメッセージファイルの場所を生成します。セクション10.2「エラーメッセージ言語の設定」を参照してください。 -
Property Value コマンド行形式 --lc-messages-dir=dir_nameシステム変数 lc_messages_dirスコープ グローバル 動的 いいえ 型 ディレクトリ名 エラーメッセージが配置されているディレクトリ。サーバーはこの値を
--lc-messagesの値と一緒に使用して、エラーメッセージファイルの場所を生成します。セクション10.2「エラーメッセージ言語の設定」を参照してください。 -
Property Value コマンド行形式 --local-service(Windows のみ) サービス名のあとに
--local-serviceオプションが指定されると、システム権限が制限されたLocalServiceの Windows アカウントを使用してサーバーが実行されます。このアカウントは Windows XP またはそれ以降でのみ利用できます。--defaults-fileおよび--local-serviceの両方がサービス名のあとに指定される場合、どのような順序でもかまいません。セクション2.3.5.7「Windows のサービスとして MySQL を起動する」を参照してください。 -
--log[=,file_name]-l [file_name]Property Value コマンド行形式 --log[=file_name]非推奨 はい (removed in 5.6.1); use general-logシステム変数 logスコープ グローバル 動的 はい 型 ファイル名 --logオプションは MySQL 5.6.1 で (logシステム変数と一緒に) 削除されました。代わりに、一般クエリーログを有効にするには--general_logオプションを使用し、一般クエリーログファイル名を設定するには--general_log_file=オプションを使用してください。file_name -
Property Value コマンド行形式 --log-error[=file_name]システム変数 log_errorスコープ グローバル 動的 いいえ 型 ファイル名 エラーおよび起動メッセージのログをこのファイルに記録します。セクション5.2.2「エラーログ」 を参照してください。ファイル名を省略すると、MySQL は
host_name.err.errを追加します。 -
Property Value コマンド行形式 --log-isam[=file_name]型 ファイル名 MyISAMのすべての変更内容をこのファイルに記録します (MyISAMをデバッグするときだけ使用します)。 -
Property Value コマンド行形式 --log-output=nameシステム変数 log_outputスコープ グローバル 動的 はい 型 セット デフォルト FILE有効な値 TABLEFILENONEこのオプションは、一般クエリーログおよびスロークエリーログの出力先を決定します。オプション値は、
TABLE、FILE、NONEの 1 つ以上の文字で指定できます。TABLEは、宛先としてmysqlデータベース内のgeneral_logおよびslow_logテーブルへのロギングを選択します。FILEは、ログファイルを宛先としたロギングを選択します。NONEはロギングを無効にします。NONEがオプション値にある場合は、存在するすべての文字よりも優先されます。TABLEおよびFILEを両方指定して、両方のログ出力の宛先を選択できます。このオプションはログ出力の宛先を選択しますが、ログ出力を有効化しません。これを行うには、
--general_logおよび--slow_query_logオプションを使用します。FILEでのロギングの場合、--general_log_fileオプションおよび-slow_query_log_fileオプションによってログファイルの場所が決定されます。詳細については、セクション5.2.1「一般クエリーログおよびスロークエリーログの出力先の選択」を参照してください。 -
--log-queries-not-using-indexesProperty Value コマンド行形式 --log-queries-not-using-indexesシステム変数 log_queries_not_using_indexesスコープ グローバル 動的 はい 型 ブール デフォルト OFFスロークエリーログを有効にしてこのオプションを使用した場合、すべての行を取得することが予想されるクエリーがログに記録されます。セクション5.2.5「スロークエリーログ」を参照してください。このオプションは、インデックスが使用されないことを必ずしも意味するわけではありません。たとえば、フルインデックススキャンを使用するクエリーはインデックスを使用しますが、インデックスは行数を制限しないため、クエリーはログに記録されます。
-
Property Value コマンド行形式 --log-raw[=value]導入 5.6.3 型 ブール デフォルト OFFMySQL 5.6.3 以降では、一般クエリーログ、スロークエリーログ、およびバイナリログに書き込まれる特定のステートメントのパスワードは、文字どおり平文で出現しないようにサーバーによって書き直されます。一般クエリーログについてのパスワードの書き換えは、
--log-rawオプションでサーバーを起動することによって抑制できます。このオプションは、サーバーによって受け取られるステートメントの正確なテキストを表示する際の診断目的で役立つ場合がありますが、セキュリティー上の理由で本番用途では推奨されません。MySQL 5.6.3 より前では、ステートメント内のパスワードは書き換えられないため、一般クエリーログを保護するようにしてください。セクション6.1.2.3「パスワードおよびロギング」を参照してください。
このオプションは MySQL 5.6.3 で追加されました。
-
Property Value コマンド行形式 --log-short-format型 ブール デフォルト FALSEバイナリログおよびスロークエリーログがアクティブ化されている場合、これらのログに記録する情報を少なくします。
-
Property Value コマンド行形式 --log-slow-admin-statements(<= 5.6.10)削除 5.6.11 型 ブール デフォルト OFFスロークエリーログに書き込まれるステートメントにスロー管理ステートメントを含めます。管理ステートメントには、
ALTER TABLE、ANALYZE TABLE、CHECK TABLE、CREATE INDEX、DROP INDEX、OPTIMIZE TABLE、およびREPAIR TABLEが含まれます。このコマンド行オプションは MySQL 5.6.11 で削除され、
log_slow_admin_statementsシステム変数によって置き換えられました。システム変数はオプションと同じ方法でコマンド行またはオプションファイルに設定できるため、サーバー起動時に何らかの変更を行う必要はありませんが、システム変数は実行時に値を検査または設定することも可能です。 -
--log-slow-queries[=file_name]Property Value コマンド行形式 --log-slow-queries[=name]非推奨 はい (removed in 5.6.1); use slow-query-logシステム変数 log_slow_queriesスコープ グローバル 動的 はい 型 ブール --log-slow-queriesオプションは MySQL 5.6.1 で (log_slow_queriesシステム変数と一緒に) 削除されました。代わりに、スロークエリーログを有効にするには--slow_query_logオプションを使用し、スロークエリーログファイル名を設定するには--slow_query_log_file=オプションを使用してください。file_name -
Property Value コマンド行形式 --log-tc=file_name型 ファイル名 デフォルト tc.logメモリーマップ済みのトランザクションコーディネータログファイルの名前 (バイナリログが無効のときに複数のストレージエンジンに影響する XA トランザクション用)。デフォルト名は
tc.logです。フルパス名が指定されない場合、ファイルはデータディレクトリの下に作成されます。現在このオプションは使用されていません。 -
Property Value コマンド行形式 --log-tc-size=#型 数値 デフォルト 24576最大値 (64 ビットプラットフォーム) 18446744073709551615最大値 (32 ビットプラットフォーム) 4294967295メモリーマップ済みのトランザクションコーディネータログのバイト単位のサイズ。デフォルトサイズは 24K バイトです。
-
--log-warnings[=,level]-W [level]Property Value コマンド行形式 --log-warnings[=#]システム変数 log_warningsスコープ (>= 5.6.4) グローバル スコープ (<= 5.6.3) グローバル、セッション 動的 はい 型 数値 デフォルト 1最小値 0最大値 (64 ビットプラットフォーム) 18446744073709551615最大値 (32 ビットプラットフォーム) 4294967295「Aborted connection...」などの警告をエラーログに出力します。このオプションは、デフォルトで有効 (1) になっています。これを無効にするには、--log-warnings=0を使用します。level値を付けずにオプションを指定すると、現在の値が 1 増加します。レプリケーションを使用するなどの場合は、このオプションを 0 より大きく設定して有効にすることを推奨します (ネットワーク障害や再接続についてのメッセージなど、発生中の詳細情報を受け取ります)。値が 1 より大きい場合、中止された接続がエラーログに書き込まれ、新しい接続の試行についてのアクセス拒否エラーが書き込まれます。セクションB.5.2.11「通信エラーおよび中止された接続」を参照してください。スレーブサーバーが
--log-warningsを有効にして起動された場合、スレーブは、スレーブのステータスに関する情報を提供するためのメッセージをエラーログに出力し、この情報には、スレーブがジョブを開始したときのバイナリログおよびリレーログの座標、別のリレーログに切り替える時期、切断後に再接続する時期などがあります。--log-warningsが 0 より大きい場合、サーバーはステートメントベースのロギングについて、安全ではないステートメントに関するメッセージをログに記録します。 -
Property Value コマンド行形式 --low-priority-updatesシステム変数 low_priority_updatesスコープ グローバル、セッション 動的 はい 型 ブール デフォルト FALSEテーブル変更操作 (
INSERT、REPLACE、DELETE、UPDATE) に、選択よりも低い優先順位を与えます。これは{INSERT | REPLACE | DELETE | UPDATE} LOW_PRIORITY ...を使用して 1 つのクエリーのみ優先順位を下げたり、SET LOW_PRIORITY_UPDATES=1によって 1 つのスレッドの優先順位を変更したりして実行することもできます。これは、テーブルレベルロックのみを使用するストレージエンジン (MyISAM、MEMORY、MERGE) にのみ影響を与えます。セクション8.10.2「テーブルロックの問題」を参照してください。 -
--min-examined-row-limit=numberProperty Value コマンド行形式 --min-examined-row-limit=#システム変数 min_examined_row_limitスコープ グローバル、セッション 動的 はい 型 数値 デフォルト 0最小値 0最大値 (64 ビットプラットフォーム) 18446744073709551615最大値 (32 ビットプラットフォーム) 4294967295このオプションを設定すると、
number行より少ない行を検査するクエリーがスロークエリーログに書き込まれません。デフォルトは 0 です。 -
Property Value コマンド行形式 --memlock型 ブール デフォルト FALSEメモリー内の mysqld プロセスをロックします。このオプションは、オペレーティングシステムによって mysqld がディスクへのスワップを実行するという問題がある場合に役立つことがあります。
--memlockは、mlockall()システムコールをサポートするシステム上で機能し、システムには、Solaris、2.4 またはそれより新しいカーネルを使用するほとんどの Linux 配布、およびその他の UNIX システムが含まれます。Linux システムの場合、mlockall()(およびこのオプション) が、システムのmman.hファイルで定義されているかどうかを次のようにして確認することによって、これがサポートされているかどうかを識別できます。shell> grep mlockall /usr/include/sys/mman.hmlockall()がサポートされている場合、前のコマンドの出力に、次のように表示されます。extern int mlockall (int __flags) __THROW;重要このオプションを使用する場合、サーバーを
rootとして実行することが必要な場合もあり、これはセキュリティー上の理由から通常はよい考えではありません。セクション6.1.5「MySQL を通常ユーザーとして実行する方法」を参照してください。Linux およびおそらくその他のシステムでは、
limits.confファイルを変更することによって、サーバーをrootとして実行しないで済みます。セクション8.11.4.2「ラージページのサポートの有効化」の memlock 制限に関するメモを参照してください。mlockall()システムコールをサポートしないシステムでは、このオプションを使用しないでください。これを行うと、mysqld は開始してすぐに高い確率でクラッシュします。 -
Property Value コマンド行形式 --myisam-block-size=#型 数値 デフォルト 1024最小値 1024最大値 16384MyISAMインデックスページに使用するブロックサイズ。 -
--myisam-recover-options[=option[,option]...]]Property Value コマンド行形式 --myisam-recover-options[=name]型 列挙 デフォルト OFF有効な値 OFFDEFAULTBACKUPFORCEQUICKMyISAMのストレージエンジンのリカバリモードを設定します。オプション値は、OFF、DEFAULT、BACKUP、FORCE、またはQUICKの任意の組み合わせです。複数の値を指定する場合、値をカンマで区切ります。オプションに引数を指定しないことはDEFAULTを指定するのと同じで、明示的な値""を指定するとリカバリが無効になります (値OFFと同じ)。リカバリが有効な場合、mysqld はMyISAMテーブルをオープンするたび、テーブルがクラッシュしたというマークが付いているか、テーブルが正しくクローズしなかったかどうかをチェックします。(最後のオプションは外部ロックを無効にして実行している場合のみ機能します。)このような場合、mysqld はテーブル上でチェックを実行します。テーブルが破損していた場合、mysqld は修復を試みます。次のオプションは修復の動作方法に影響します。
オプション 説明 OFFリカバリなし。 DEFAULTバックアップ、強制、クイックチェックを行わないリカバリ。 BACKUPデータファイルがリカバリ中に変更された場合、 tbl_name.MYDtbl_name-datetime.BAKFORCE.MYDファイルから複数のレコードがなくなる場合でもリカバリを実行します。QUICK削除ブロックがない場合、テーブルの行をチェックしません。 サーバーがテーブルを自動的に修復する前に、サーバーは修復に関するメモをエラーログに書き込みます。ユーザーが介入せずにほとんどの問題をリカバリできるようにするには、
BACKUP,FORCEオプションを使用します。これにより、一部の行が削除される場合でもテーブルの修復を強制しますが、古いデータファイルをバックアップとして保持しているため、何が発生したかをあとで検査できます。セクション15.2.1「MyISAM 起動オプション」を参照してください。
-
オプションファイルを読み取りません。オプションファイルから不明のオプションを読み取ることが原因でプログラムの起動に失敗する場合、
--no-defaultsを使用して、オプションを読み取らないようにできます。例外として、
.mylogin.cnfファイルは、存在する場合はすべての場合に読み取られます。これにより、--no-defaultsが使用されたとしても、コマンド行よりも安全な方法でパスワードを指定できます (.mylogin.cnfは mysql_config_editor ユーティリティーによって作成されます。セクション4.6.6「mysql_config_editor — MySQL 構成ユーティリティー」を参照してください)。 -
Property Value コマンド行形式 --old-alter-tableシステム変数 old_alter_tableスコープ グローバル、セッション 動的 はい 型 ブール デフォルト OFFこのオプションが指定された場合、サーバーは
ALTER TABLE操作の処理の最適化された方式を使用しません。一時テーブルの使用に戻り、データのコピー後、MySQL 5.0 以前で使用されていたように、一時テーブルを元のテーブルの名前に変更します。ALTER TABLEの操作について詳しくは、セクション13.1.7「ALTER TABLE 構文」を参照してください。 -
Property Value コマンド行形式 --old-style-user-limits型 ブール デフォルト FALSE古いスタイルのユーザー制限を有効にします。(MySQL 5.0.3 以前では、アカウントリソースは、
userテーブルのアカウント行単位ではなく、ユーザーが接続したホストごとに別々にカウントされていました。)セクション6.3.4「アカウントリソース制限の設定」を参照してください。 -
Property Value コマンド行形式 --one-thread削除 5.6.1 このオプションは MySQL 5.6.1 で削除されました。代わりに
--thread_handling=no-threadsを使用してください。 -
Property Value コマンド行形式 --open-files-limit=#システム変数 open_files_limitスコープ グローバル 動的 いいえ 型 数値 デフォルト (>= 5.6.8) 5000, with possible adjustmentデフォルト (<= 5.6.7) 0最小値 0最大値 platform dependentmysqld で使用可能なファイルディスクリプタの数を変更します。mysqld が
「Too many open files」のエラーを出す場合、このオプションの値を増やしてみてください。mysqld はこのオプション値を使用して、setrlimit()でディスクリプタを予約します。内部的には、このオプションの最大値は符号なし整数値の最大値ですが、実際の最大値はプラットフォームに依存します。リクエストされた数のファイルディスクリプタを割り当てできない場合、mysqld はエラーログに警告を書き込みます。mysqld は、
max_connectionsおよびtable_open_cacheの値を使用して、さらに多くのディスクリプタが必要かどうかを推定し、(利用可能な場合は) リクエストされた数のディスクリプタよりも多くを割り当てようとする場合もあります。UNIX の場合、値を ulimit -n より少なく設定できません。
-
Property Value コマンド行形式 --partition無効化 skip-partition型 ブール デフォルト ONMySQL Server サーバーのユーザー定義のパーティショニングサポートを有効または無効にします。
-
--performance-schema-xxxパフォーマンススキーマオプションを構成します。詳細については、セクション22.11「パフォーマンススキーマコマンドオプション」を参照してください。
-
Property Value コマンド行形式 --pid-file=file_nameシステム変数 pid_fileスコープ グローバル 動的 いいえ 型 ファイル名 プロセス ID ファイルのパス名。サーバーは、別のディレクトリを指定する絶対パス名が指定されないかぎり、データディレクトリ内にファイルを作成します。このファイルは、mysqld_safe などの別のプログラムによってサーバーのプロセス ID を判別するときに使用されます。
-
サーバープラグインに関するオプションを指定します。たとえば、多くのストレージエンジンはプラグインとして構築でき、そのようなエンジンに対してそれらのオプションを
--pluginプリフィクスで指定できます。したがって、InnoDBの--innodb_file_per_tableオプションを--plugin-innodb_file_per_tableのように指定できます。有効または無効にできるブールオプションの場合、
--skipプリフィクスおよびその他の代替形式もサポートされます (セクション4.2.5「プログラムオプション修飾子」を参照してください)。たとえば、--skip-plugin-innodb_file_per_tableはinnodb_file_per_tableを無効にします。--pluginプリフィクスの理由として、組み込みサーバーオプションとの名前の競合がある場合に、あいまいさを排除してプラグインオプションを指定できるということがあります。たとえば、プラグイン 「sql」 に名前を指定し 「mode」 オプションを実装するプラグインライターは、オプション名が--sql-modeとなることがあり、同じ名前の組み込みオプションと競合します。そのような場合、競合する名前への参照は、組み込みオプション側として解決されます。あいまいさを避けるために、ユーザーはプラグインオプションを--plugin-sql-modeとして指定できます。あいまいさの問題を避けるために、プラグインオプションに--pluginプリフィクスを使用することを推奨します。 -
Property Value コマンド行形式 --plugin-load=plugin_list型 文字列 このオプションは、指定されたプラグインを起動時にロードするようサーバーに指示します。オプション値は、セミコロンで区切られた
name=plugin_librarynameはプラグインの名前で、plugin_libraryはプラグインコードを含む共有ライブラリの名前です。各ライブラリファイルは、plugin_dirシステム変数によって指定されるディレクトリに配置されている必要があります。たとえば、myplug1およびmyplug2という名前のプラグインが、ライブラリファイルmyplug1.soおよびmyplug2.soを持つ場合、次のオプションを使用して、これらを起動時にロードします。shell> mysqld --plugin-load="myplug1=myplug1.so;myplug2=myplug2.so"ここでは引数の前後に引用符が使用されますが、これはセミコロン (
;) が一部のコマンドインタプリタによって特殊文字として解釈されるためです。(たとえば UNIX シェルでは、これはコマンド終端記号として扱われます。)複数の
--plugin-loadオプションが指定された場合、最後のオプションのみが使用されます。ロードする追加のプラグインは、--plugin-load-addオプションを使用して指定できます。プラグイン名を前に付けずにプラグインライブラリを指定した場合、サーバーはライブラリ内のすべてのプラグインをロードします。
各プラグインは、mysqld の単一の呼び出しについてのみロードされます。再起動後、
--plugin-loadをふたたび使用しないかぎり、プラグインはロードされません。これはINSTALL PLUGINとは対照的で、こちらはmysql.pluginsテーブルに項目を追加することで、サーバーが通常起動するたびにプラグインがロードされます。通常の起動では、サーバーは
mysql.pluginsシステム変数を読み取ることによって、ロードするプラグインを判別します。サーバーが--skip-grant-tablesオプションで起動された場合、サーバーはmysql.pluginsテーブルを参照せず、そこにリストされているプラグインをロードしません。--plugin-loadにより、--skip-grant-tablesが指定されている場合でもプラグインのロードを可能にします。--plugin-loadは、プラグインを実行時にロードできない構成で、プラグインを起動時にロードできるようにします。プラグインのロードについての追加情報は、セクション5.1.8.1「プラグインのインストールおよびアンインストール」を参照してください。
-
Property Value コマンド行形式 --plugin-load-add=plugin_list導入 5.6.3 型 文字列 このオプションは
--plugin-loadオプションを補完します。--plugin-load-addは、起動時にロードされるプラグインのセットに 1 つまたは複数のプラグインを追加します。引数の形式は--plugin-loadと同じです。--plugin-load-addは、大量のプラグインのセットを、長くて扱いにくい単一の--plugin-load引数として指定しないようにできます。このオプションは MySQL 5.6.3 で追加されました。--plugin-load-addは--plugin-loadがなくても指定できますが、--plugin-loadはロードするプラグインのセットをリセットするため、--plugin-loadの前に出現するすべての--plugin-load-addは効果がありません。つまり、次のオプションの場合、--plugin-load=x --plugin-load-add=y上記は次のオプションと同等です。
--plugin-load="x;y"ただし、次のオプションの場合、
--plugin-load-add=y --plugin-load=x上記は次のオプションと同等です。
--plugin-load=xプラグインのロードについての追加情報は、セクション5.1.8.1「プラグインのインストールおよびアンインストール」を参照してください。
-
Property Value コマンド行形式 --port=#システム変数 portスコープ グローバル 動的 いいえ 型 数値 デフォルト 3306最小値 0最大値 65535TCP/IP 接続を listen するときに使用するポート番号。サーバーが
rootシステムユーザーで開始されている場合を除き、ポート番号は 1024 以上にする必要があります。 -
Property Value コマンド行形式 --port-open-timeout=#型 数値 デフォルト 0一部のシステムでは、サーバーが停止すると、TCP/IP ポートがただちに利用できなくなることがあります。その後すぐにサーバーを再起動した場合、サーバーがポートをふたたびオープンしようとして失敗することがあります。このオプションは、TCP/IP ポートを開くことができない場合、TCP/IP ポートが開放されるまでサーバーが待機する秒数を指示します。デフォルトでは待機しません。
-
プログラム名と、オプションファイルから受け取るすべてのオプションを出力します。
-
Property Value コマンド行形式 --remove [service_name]プラットフォーム固有 Windows (Windows のみ) MySQL Windows サービスを削除します。
service_nameの値が指定されない場合、デフォルトサービス名はMySQLです。詳細については、セクション2.3.5.7「Windows のサービスとして MySQL を起動する」を参照してください。 -
Property Value コマンド行形式 --safe-mode非推奨 はい (removed in 5.6.6) 一部の最適化ステージをスキップします。このオプションは MySQL 5.6.6 で削除されました。
-
Property Value コマンド行形式 --safe-user-create型 ブール デフォルト FALSEこのオプションが有効な場合、ユーザーが
mysql.userテーブルまたはテーブル内の任意のカラムに対してINSERT権限を持つ場合を除き、ユーザーはGRANTステートメントを使用して新しい MySQL ユーザーを作成できません。あるユーザーが新規ユーザーを作成する能力を持ち、そのユーザーが付与する権利を持つ権限を、新規ユーザーが持つようにするには、そのユーザーに次の権限を付与します。GRANT INSERT(user) ON mysql.user TO 'user_name'@'host_name';これで、ユーザーは権限カラムを直接変更できませんが、
GRANTステートメントを使用してほかのユーザーに権限を与えることができるようになります。 -
Property Value コマンド行形式 --secure-authシステム変数 secure_authスコープ グローバル 動的 はい 型 ブール デフォルト (>= 5.6.5) ONデフォルト (<= 5.6.4) OFFこのオプションにより、サーバーは、古い (4.1 以前の) 形式で格納されているパスワードを持つアカウントを使用しようとする、クライアントによる接続をブロックします。古い形式を用いたすべてのパスワードの使用 (ネットワーク上でのセキュアでない通信) を防ぐために、これを使用します。MySQL 5.6.5 以前では、このオプションはデフォルトで無効になっています。MySQL 5.6.5 以降では、これはデフォルトで有効になっています。これを無効にするには、
--skip-secure-authを使用します。このオプションが有効になっていて、権限テーブルが 4.1 以前の形式の場合、サーバーの起動が失敗してエラーが出ます。セクションB.5.2.4「クライアントは認証プロトコルに対応できません」を参照してください。
mysql クライアントにも
--secure-authオプションがあり、これはサーバーがそのクライアントアカウントに対して古い形式のパスワードを要求する場合にサーバーに接続しないようにします。注記4.1 より前のハッシュ方式を使用するパスワードはネイティブのパスワードハッシュ方式を使用するパスワードよりもセキュアでないため、使用しないようにしてください。4.1 よりも前のパスワードは非推奨であり、これらのサポートは今後の MySQL リリースで削除される予定です。これにより、
--skip-secure-authを使用したセキュア認証の無効化も非推奨になります。 -
Property Value コマンド行形式 --secure-file-priv=pathシステム変数 secure_file_privスコープ グローバル 動的 いいえ 型 文字列 このオプションは、
LOAD_FILE()関数とLOAD DATAおよびSELECT ... INTO OUTFILEステートメントの効果を制限し、指定されたディレクトリ内のファイルにのみ作用します。 -
Property Value コマンド行形式 --shared-memory-base-name=nameシステム変数 shared_memoryスコープ グローバル 動的 いいえ プラットフォーム固有 Windows ローカルクライアントによる共有メモリー接続を有効にします。このオプションは Windows でのみ使用できます。
-
--shared-memory-base-name=nameProperty Value システム変数 shared_memory_base_nameスコープ グローバル 動的 いいえ プラットフォーム固有 Windows 共有メモリー接続に使用する共有メモリーの名前。このオプションは Windows でのみ使用できます。デフォルト名は
MYSQLです。名前は大文字と小文字を区別します。 -
MyISAMテーブルに対する SELECT 文と INSERT 文の同時実行を無効化します。(これは、この機能にバグが見つかったと思われる場合のみ使用します。)セクション8.10.3「同時挿入」を参照してください。 -
Property Value コマンド行形式 --skip-event-scheduler--disable-event-schedulerイベントスケジューラを
OFFにします。これは、--event-scheduler=DISABLEDの設定が必要なイベントスケジューラの無効化と同じではありません。詳細については、「--event-schedulerオプション」を参照してください。 -
このオプションにより、サーバーは権限システムをまったく使用せずに開始され、サーバーへのアクセス権を持つすべてのユーザーにすべてのデータベースに対する無制限アクセス権が与えられます。サーバー実行中に、付与テーブルの行使を再開するには、mysqladmin flush-privileges または mysqladmin reload コマンドをシステムシェルから実行するか、サーバーへの接続後に MySQL
FLUSH PRIVILEGESステートメントを発行します。このオプションは、INSTALL PLUGINステートメント、ユーザー定義関数 (UDF)、およびスケジュールされたイベントでインストールされたプラグインのロードも抑制します。プラグインをロードするには、--plugin-loadオプションを使用します。FLUSH PRIVILEGESは起動後に実行されるほかのアクションによって暗黙的に実行される場合があります。たとえば、mysql_upgrade はアップグレード手続き中に権限をフラッシュします。 -
名前と IP の解決を高速化するために内部ホストキャッシュの使用を無効にします。この場合、サーバーはクライアントが接続するたびに DNS ルックアップを実行します。セクション8.11.5.2「DNS ルックアップの最適化とホストキャッシュ」を参照してください。
--skip-host-cacheの使用はhost_cache_sizeシステム変数を 0 に設定することに似ていますが、host_cache_sizeの方が柔軟性が高く、これはサーバー起動時だけでなく実行時にもホストキャッシュのサイズを変更したり有効化または無効化したりするために使用できるためです。--skip-host-cacheを指定してサーバーを開始しても、host_cache_sizeの値の変更を妨げるわけではありませんが、この変更は効果がなく、host_cache_sizeを 0 より大きく設定してもキャッシュはふたたび有効化されません。 -
InnoDBストレージエンジンを無効にします。この場合、デフォルトのストレージエンジンはInnoDBであるため、--default-storage-engineおよび--default-tmp-storage-engineを使用して、永続テーブルとTEMPORARYテーブルの両方についてデフォルトを別のエンジンに設定しないかぎりサーバーは開始しません。MySQL 5.6.21 以降では、
--skip-innodbオプションは非推奨です。これを使用すると警告が出ます。このオプションは今後の MySQL リリースで削除されます。 -
クライアント接続を検査するときにホスト名を解決しません。IP アドレスのみを使用します。このオプションを使用する場合、付与テーブルのすべての
Hostカラムの値は IP アドレスまたはlocalhostである必要があります。セクション8.11.5.2「DNS ルックアップの最適化とホストキャッシュ」を参照してください。システムのネットワーク構成およびアカウントの
Host値によっては、クライアントは--host=localhost、--host=127.0.0.1、--host=::1などの明示的な--hostオプションを使用して接続する必要がある場合もあります。 -
TCP/IP 接続を listen しません。mysqld とのすべての対話は、名前付きパイプまたは共有メモリー (Windows の場合) または UNIX ソケットファイル (UNIX の場合) を使用して行う必要があります。このオプションは、ローカルクライアントのみが許可されているシステムで強く推奨します。セクション8.11.5.2「DNS ルックアップの最適化とホストキャッシュ」を参照してください。
-
Property Value コマンド行形式 --skip-partition--disable-partitionユーザー定義のパーティショニングを無効にします。パーティション化されたテーブルは、
SHOW TABLESを使用するか、INFORMATION_SCHEMA.TABLESテーブルを照会することで表示できますが、作成または変更することはできず、そのようなテーブルのデータにアクセスすることもできません。INFORMATION_SCHEMA.PARTITIONSテーブル内のパーティション固有のすべてのカラムにはNULLが表示されます。DROP TABLEによってテーブル定義 (.frm) ファイルが削除されるため、このオプションを使用してパーティショニングが無効化されていても、このステートメントはパーティション化されたテーブルで機能します。ただしこのような場合、このステートメントはパーティション化されたテーブルに関連付けられた.parファイルを削除しません。このため、パーティショニングを無効化したパーティション化されたテーブルをドロップしないようにするか、孤立した.parファイルを手動で削除してください。 -
--sslで始まるオプションは、クライアントが SSL を使用して接続することを許可するかどうかを指定し、SSL 鍵および証明書を見つける場所を指定します。セクション6.3.10.4「SSL コマンドのオプション」を参照してください。 -
Property Value コマンド行形式 --standaloneプラットフォーム固有 Windows Windows でのみ使用可能で、MySQL Server にサービスとして実行しないよう指示します。
-
Property Value コマンド行形式 --super-large-pagesプラットフォーム固有 Solaris 型 ブール デフォルト FALSEMySQL での標準的な大規模ページの使用では、サポートされる最大サイズである 4M バイトまでの使用が試行されます。Solaris では「超大規模ページ」機能により 256M バイトまでのページの使用が可能です。この機能は最新の SPARC プラットフォームで使用できます。これは
--super-large-pagesまたは--skip-super-large-pagesオプションを使用して有効または無効にできます。 -
--symbolic-links、--skip-symbolic-linksProperty Value コマンド行形式 --symbolic-linksシンボリックリンクサポートを有効または無効にします。このオプションは、Windows と UNIX で異なる効果になります。
Windows では、シンボリックリンクを有効にすることで、実際のディレクトリへのパスを含む
db_name.symUNIX では、シンボリックリンクを有効にすることは、
CREATE TABLEステートメントのINDEX DIRECTORYまたはDATA DIRECTORYオプションを使用してMyISAMインデックスファイルまたはデータファイルを別のディレクトリにリンクできることを意味します。テーブルを削除したり名前変更したりすると、そのシンボリックリンクが指定するファイルも削除されたり名前が変更されたりします。セクション8.11.3.1.2「Unix 上の MyISAM へのシンボリックリンクの使用」を参照してください。
-
Property Value コマンド行形式 --skip-show-databaseシステム変数 skip_show_databaseスコープ グローバル 動的 いいえ このオプションは、
SHOW DATABASESステートメントを使用することが許可されているユーザーを制御するskip_show_databaseシステム変数を設定します。セクション5.1.4「サーバーシステム変数」を参照してください。 -
Property Value コマンド行形式 --skip-stack-traceスタックトレースを書き込みません。このオプションは、デバッガで mysqld を実行するときに役立ちます。一部のシステムでは、コアファイルを取得するために、このオプションの使用が必要になることもあります。セクション24.4「MySQL のデバッグおよび移植」 を参照してください。
-
Property Value コマンド行形式 --skip-thread-priority非推奨 はい (removed in 5.6.1) 応答速度を高めるために、スレッド優先順位の使用を無効にします。このオプションは使用されておらず、MySQL 5.6.1 で削除されました。
-
Property Value コマンド行形式 --slow-query-logシステム変数 slow_query_logスコープ グローバル 動的 はい 型 ブール デフォルト OFFスロークエリーログの初期状態を指定します。引数がないか引数が 1 の場合、
--slow-query-logオプションはログを使用可能にします。省略されるか引数が 0 の場合、オプションはログを使用不可にします。 -
Property Value コマンド行形式 --slow-start-timeout=#導入 5.6.5 型 数値 デフォルト 15000このオプションは、Windows サービスコントロールマネージャーのサービス開始タイムアウトを制御します。この値は、起動時に Windows サービスを強制終了する前に、サービスコントロールマネージャーが待機する最大のミリ秒数です。デフォルト値は 15000 (15 秒) です。MySQL サービスの開始に時間がかかりすぎる場合、この値を増やすことが必要なこともあります。値 0 は、タイムアウトがないことを意味します。
-
Property Value コマンド行形式 --socket=file_nameシステム変数 socketスコープ グローバル 動的 いいえ 型 ファイル名 デフォルト /tmp/mysql.sockUNIX の場合、このオプションは、ローカル接続用の listen を行うときに使用する UNIX ソケットファイルを指定します。デフォルト値は
/tmp/mysql.sockです。このオプションが指定された場合、別のディレクトリを指定する絶対パス名が指定されないかぎり、サーバーはデータディレクトリにファイルを作成します。Windows の場合、このオプションは、名前付きパイプを使用する、ローカル接続用の listen を行うときに使用するパイプ名を指定します。デフォルト値はMySQLです (大文字小文字の区別はありません)。 -
--sql-mode=value[,value[,value...]]Property Value コマンド行形式 --sql-mode=nameシステム変数 sql_modeスコープ グローバル、セッション 動的 はい 型 セット デフォルト (>= 5.6.6) NO_ENGINE_SUBSTITUTIONデフォルト (<= 5.6.5) ''有効な値 ALLOW_INVALID_DATESANSI_QUOTESERROR_FOR_DIVISION_BY_ZEROHIGH_NOT_PRECEDENCEIGNORE_SPACENO_AUTO_CREATE_USERNO_AUTO_VALUE_ON_ZERONO_BACKSLASH_ESCAPESNO_DIR_IN_CREATENO_ENGINE_SUBSTITUTIONNO_FIELD_OPTIONSNO_KEY_OPTIONSNO_TABLE_OPTIONSNO_UNSIGNED_SUBTRACTIONNO_ZERO_DATENO_ZERO_IN_DATEONLY_FULL_GROUP_BYPAD_CHAR_TO_FULL_LENGTHPIPES_AS_CONCATREAL_AS_FLOATSTRICT_ALL_TABLESSTRICT_TRANS_TABLESSQL モードを設定します。MySQL 5.6.6 より前では、デフォルトは
''(空の文字列) でしたが、MySQL 5.6.6 以降では、デフォルトはNO_ENGINE_SUBSTITUTIONです。セクション5.1.7「サーバー SQL モード」を参照してください。注記MySQL インストールプログラムはインストールプロセス中に SQL モードを構成することがあります。たとえば、mysql_install_db は、
my.cnfという名前のデフォルトオプションファイルを基本インストールディレクトリに作成します。このファイルには、SQL モードを設定する行が含まれています。セクション4.4.3「mysql_install_db — MySQL データディレクトリの初期化」を参照してください。SQL モードがデフォルトまたは期待されているモードと異なる場合、サーバーが起動時に読み取るオプションファイル内の設定を確認してください。
-
Property Value コマンド行形式 --sysdate-is-now型 ブール デフォルト FALSEデフォルトの
SYSDATE()は、この関数があるステートメントの実行が開始された時間ではなく、この関数が実行された時間を返します。これはNOW()の動作と異なります。このオプションによって、SYSDATE()をNOW()のエイリアスにできます。バイナリロギングおよびレプリケーションに対する意味については、セクション12.7「日付および時間関数」のSYSDATE()および セクション5.1.4「サーバーシステム変数」のSET TIMESTAMPについての説明を参照してください。 -
--tc-heuristic-recover={COMMIT|ROLLBACK}Property Value コマンド行形式 --tc-heuristic-recover=name型 列挙 デフォルト COMMIT有効な値 COMMITROLLBACK経験則によるリカバリプロセスで使用する決定のタイプ。現在このオプションは使用されていません。
-
Property Value コマンド行形式 --temp-pool型 ブール デフォルト TRUEこのオプションにより、サーバーによって作成されるほとんどの一時ファイルが、新規ファイルごとに一意の名前を使用するのではなく、少数の名前のセットを使用するようになります。これは、異なる名前で多くの新規ファイルの作成を処理する Linux カーネルでの問題を回避します。Linux では、メモリーがディスクキャッシュではなくディレクトリエントリキャッシュへの割り当てになるため、従来の動作ではメモリーの「リーク」が発生しがちです。このオプションは Linux 以外では無視されます。
-
Property Value コマンド行形式 --transaction-isolation=name型 列挙 デフォルト REPEATABLE-READ有効な値 READ-UNCOMMITTEDREAD-COMMITTEDREPEATABLE-READSERIALIZABLEデフォルトのトランザクション分離レベルを設定します。
level値は、READ-UNCOMMITTED、READ-COMMITTED、REPEATABLE-READ、またはSERIALIZABLEに設定できます。セクション13.3.6「SET TRANSACTION 構文」を参照してください。デフォルトのトランザクション分離レベルは
SET TRANSACTIONステートメントを使用するか、tx_isolationシステム変数を設定することによって実行時にも設定できます。 -
Property Value コマンド行形式 --transaction-read-only導入 5.6.5 型 ブール デフォルト OFFデフォルトのトランザクションアクセスモードを設定します。デフォルトでは読み取り専用モードが無効化されているため、モードは読み取り/書き込みです。
デフォルトのトランザクションアクセスモードを実行時に設定するには、
SET TRANSACTIONステートメントを使用するか、tx_read_onlyシステム変数を設定します。セクション13.3.6「SET TRANSACTION 構文」を参照してください。このオプションは MySQL 5.6.5 で追加されました。
-
Property Value コマンド行形式 --tmpdir=pathシステム変数 tmpdirスコープ グローバル 動的 いいえ 型 ディレクトリ名 一時ファイルを作成するために使用するディレクトリのパス。これは、小さすぎて一時テーブルを保持できないパーティション上にデフォルトの
/tmpディレクトリがある場合に役立つことがあります。このオプションは、ラウンドロビン方式で使用されるいくつかのパスを受け入れます。パスは UNIX ではコロン文字 (「:」)、Windows ではセミコロン文字 (「;」) で区切るようにしてください。MySQL Server がレプリケーションスレーブとして動作する場合、--tmpdirを、メモリーベースのファイルシステム上のディレクトリや、サーバーホストが再起動したときにクリアされるディレクトリに指定するように設定しないでください。一時ファイルのストレージ位置に関しては、セクションB.5.4.4「MySQL が一時ファイルを格納する場所」を参照してください。レプリケーションスレーブは、一部の一時ファイルがマシンの再起動後も存続し、一時テーブルまたはLOAD DATA INFILE操作を複製できるようにする必要があります。サーバーが再起動したときに一時ファイルディレクトリ内のファイルが消失した場合、レプリケーションは失敗します。 -
--user={,user_name|user_id}-u {user_name|user_id}Property Value コマンド行形式 --user=name型 文字列 mysqld サーバーを、名前
user_nameまたは数字ユーザー IDuser_idを持つユーザーとして実行します。(このコンテキストでの「ユーザー」は、システムログインアカウントであり、付与テーブルにリストされている MySQL ユーザーではありません。)mysqld を
rootとして起動する場合、このオプションは必須です。サーバーは起動シーケンス中にそのユーザー ID を変更し、rootではなく特定のユーザーでこれを実行します。セクション6.1.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オプションが検出されると警告を出します。 -
詳細なヘルプを得るには、このオプションを
--helpオプションと一緒に使用します。 -
バージョン情報を表示して終了します。
-- の形式のオプションを使用して、サーバーシステム変数に値を割り当てることができます。たとえば、var_name=value--key_buffer_size=32M は key_buffer_size 変数を 32M バイトの値に設定できます。
変数に値を割り当てた場合、MySQL は特定の範囲内にとどまるようにするために値を自動的に修正したり、特定の値のみが許可されていたりする場合は許容できるもっとも近い値に値を調整します。
実行時に SET で変数を設定可能な最大値を制限するには、--maximum- コマンド行オプションを使用してこれを定義できます。
var_name=value
SET ステートメントを使用して、実行中のサーバーについてのほとんどのシステム変数の値を変更できます。セクション13.7.4「SET 構文」を参照してください。
すべての変数の詳細に加え、サーバーの起動時や実行時にこれらの設定に関する追加情報は、セクション5.1.4「サーバーシステム変数」を参照してください。システム変数の調整によるサーバーの最適化に関する情報は、セクション8.11.2「サーバーパラメータのチューニング」を参照してください。
Option: open-files-limit
It seems that the Debian upstart doesn't use the parameters defined at /etc/security/limits.conf, so when you launch mysql through the service command (and so, under upstart), it overrides those defined limits and uses the default 1024.
The solution is to modify the mysql.conf file that defines the upstart service, it is located at /etc/init/mysql.conf and add the following lines before the pre-start block:
# NB: Upstart scripts do not respect
# /etc/security/limits.conf, so the open-file limits
# settings need to be applied here.
limit nofile 32000 32000
limit nproc 32000 32000
References:
http://serverfault.com/questions/440878/changing-open-files-limit-in-mysql-5-5
http://askubuntu.com/questions/288471/cant-open-files-after-updating-server-what-changed