コマンドラインにおけるプログラムのオプションは次の法則に従って作動します。

オプションのうちの数種はオン、またはオフの切り替えをコントロールします。例えば、mysqlクライアントは、クエリから得られる結果の冒頭にカラム名の行を表示するか否かを決定するオプション--column-namesをサポートします。この作業は初期設定において可能です。けれども、データだけを読み取り初期ヘッダーラインを読み取らないようなプログラムにmysqlが出力された場合などは、この機能を無効にすることも可能です。

列名を無効にするには次のオプションのうちのいずれかを指定します。

--disable-column-names
--skip-column-names
--column-names=0

--disableと--skipの頭部と末尾=0は全て同じ働きをします。つまり、オプションをオフに切り替えます。

オプションを「enabled」に切り替えるためには、次のうちのいずれかを指定する必要があります。

--column-names
--enable-column-names
--column-names=1

もし頭部が--looseのオプションがあれば、もしプログラムがオプションを認知できない場合でもエラーで終了せず、ただ警告を発します。

shell> mysql --loose-no-such-option
mysql: WARNING: unknown option '--no-such-option'

この --loose はMySQLを同じコンピュータ上に複数回インストールした状態でプログラムを立ち上げ、オプションファイルにオプションをリストアップする時に役立ちます。 全てのバージョンには認知されないようなオプションでも --loose またはオプションファイル内では loose を入力することによって使用可能になります。オプションを認知できるバージョンでは通常通りに処理され、そうでないバージョンでは警告が表示され、そして無視されます。

その他のオプションの中で場合によってはmysqlとともに便利に働くのが--execute、または-eで、SQLステートメントをサーバに送り届けます。ステートメントはシングル、またはダブルの引用符で囲まれている必要があります。もしこの引用符内の値を使用したい場合には、ステートメントにダブルの引用符を使用し、シングルの引用符をステートメント内の値のうちのいづれかに使用します。このオプションが使用される際には、mysqlがステートメントを実行し、その後終了します。

ここで例として、次のコマンドをユーザアカウントのリスト取得のために使うことにしましょう。

shell> mysql -u root -p --execute="SELECT User, Host FROM user" mysql
Enter password: ******
+------+-----------+
| User | Host      |
+------+-----------+
|      | gigan     |
| root | gigan     |
|      | localhost |
| jon  | localhost |
| root | localhost |
+------+-----------+
shell>

長い形のタイプ（--execute）の後ろにはイコール（=）が続いている事を確認します。

上記の例ではmysqlデータベースの名前は個別の引数として認められています。しかし、同じステートメントを初期設定データベースをしていしないコマンドを使用して実行することも可能です。

mysql> mysql -u root -p --execute="SELECT User, Host FROM mysql.user"

複数のSQLステートメントはセミコロンによって切り離され、コマンドライン上に認められることもあります。

shell> mysql -u root -p -e "SELECT VERSION();SELECT NOW()"
Enter password: ******
+-----------------+
| VERSION()       |
+-----------------+
| 5.1.5-alpha-log |
+-----------------+
+---------------------+
| NOW()               |
+---------------------+
| 2006-01-05 21:19:04 |
+---------------------+

オプション--execute、または-eは、アナログ形式のコマンドをMySQLクラスターへのndb_mgm管理クライアントへと届けるために使用されることもあります。例については 項14.3.6. 「安全なシャットダウンと再起動」を参照してください。

MySQLプログラムの多くは、スタートアップのオプションをオプションファイル（時にコンフィグレーションファイルとも呼ばれる）から解読することができます。オプションファイルはよく使用されるオプションを指定するのに便利で、これによって毎回プログラムを起動させるたびにコマンドラインにおける作業を省略することができます。MySQLサーバにはMySQLによって多大なpreconfigured option filesが提供されます。

プログラムがオプションファイルを解読しているかを確認するには、--help（mysqldには--verboseと--help）を使用してプログラムを起動します。プログラムがオプションファイルを解読している場合には、ヘルプメッセージによって解読中のファイルとどのオプショングループを認識中かが表示されます。

注記 :MySQL クラスタープログラムを伴うオプションファイルについては 項14.4. 「MySQL Cluster の設定」で述べられています。

Windowsにおいて、MySQLプログラムは次のファイルからスタートアップオプションを解読します。

WINDIR ユーザのWindowsディレクトリの場所を表しています。一般的に、C:\WINDOWS もしくは C:\WINNTになります。以下のコマンドを使用して WINDIR 環境変数の値から正確なロケーションを割り出すことができます。

C:\> echo %WINDIR%

INSTALLDIR はＭｙＳＱＬのインストールディレクトリを表します。これは主に、C:\PROGRAMDIR\MySQL\MySQL 5.1 Server です。MySQL 5.1がインストールとコンフィギュレーションウィザードを使用してインストールされた場合、PROGRAMDIR がプログラムディレクトリ（通常は英語バージョンWindows上の Program Files を表します。 詳細は 項2.3.4.14. 「my.ini ファイルのロケーション」 を参照してください。

Unixにおいて、MySQLプログラムは次のファイルからスタートアップオプションを解読します。

MYSQL_HOMEはサーバ固有のファイルmy.cnfを含むディレクトリへのパスを含む環境変数です。

MYSQL_HOME がセットされていない状態で mysqld_safe プログラムを使ってサーバをスタートさせると、 mysqld_safe は次のように MYSQL_HOME をセットしようとします。

MySQL 5.1ではDATADIRのmy.cnfファイルのロケーションとしての使用は認証されていません。BASEDIR の方が良い場所です。

一般的にDATADIRは/usr/local/mysql/dataでバイナリインストールに、または/usr/local/varでソースインストールに使用されます。これはコンフィグレーションタイムに特定されたデータディレクトリロケーションであって、mysqldが起動したときの--datadirオプションに呼応しているのではないということに注意してください。--datadirの起動時の使用はサーバがオプションファイルを探す際に何の影響ももたらしません。 これはサーバがオプションを処理する前にオプションファイルを探すからです。

MySQLは指示された通りの順序でオプションファイルを探し、その中で存在するものを解読します。もし使用したいオプションファイルが存在しなければ、プレーンテキストエディタで新しく作ってください。

与えられたオプションに対して複数のインスタンスが挙がった場合には、最後のものが優先されます。ここでの唯一の例外は:mysqldに対して、--userオプションの最初のインスタンスがセキュリティー上用心のため使用され、オプションファイルのユーザ固有タイプがコマンドラインで優先されるのを防ぎます。

注記 :Unixのプラットフォームでは、MySQLは全世界から書き込み・書き取り可能なコンフィグレーションファイルを認知しません。これは故意に行われており、セキュリティー対策です。

MySQL起動時にコマンドラインにおいて与えられるロングオプションは、その全てがオプションファイルにも送られる可能性があります。プログラムに対して使用可能な存在するオプションのリストを入手するには、--helpオプションを使用してプログラムを起動してください。

オプションファイルへとオプションを特定するための構文はコマンドラインの構文と似通っており、異なる点は頭のダブルダッシュを省略するというところだけです。例えば、コマンドラインにおける--quickまたは--host=localhostは、quickまたはhost=localhostとしてオプションファイル内に指定されます。--loose-opt_nameという形のオプションをオプションファイルに指定するには、loose-opt_nameという形で入力します。

オプションファイルでは空白のラインは認識されません。空白でないラインは次のいづれかの形を取ります。

数値の値をとる変数については、値は、1024、1024²乗または1024³乗、それぞれの乗数を示すために、K、MあるいはG(大文字か小文字のいずれか)の接尾辞で与えることができます。例えば次のコマンドはmysqladminへサーバに1024回pingを打つように、そして各pingの間それぞれ10秒ずつ間を空けるようにと命令します。

mysql> mysqladmin --count=1K --sleep=10 ping

ブランクのリードと追跡はオプション名とその値から自動的に削除されます。バックスペース、タブ、復帰改行、キャリッジリターン、バックスラッシュおよびスペース文字を表わすために、オプション値の中でエスケープシーケンス‘\b’、‘\t’、‘\n’、‘\r’、‘\\’、および ‘\s’を使用することもできます。

‘\\’ エスケープシーケンスが単一のバックスラッシュを表わすので、‘\\’として各‘\’を書かなければなりません。選択肢としては、パスネームセパレータとして‘\’ではなく‘/’を使用して、値を指定することができます。

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

[client]オプショングループは、すべてのクライアントプログラム(mysqldは除く）によって解読されます。これによって全てのクライアントに当てはまるオプションを指定することが可能になります。例えば、[client]は、サーバに接続するために使用するパスワードを指定するために使用する完全なグループです（しかしオプションファイルはユーザ当事者にのみ判読可能、書き込み可能であることに注意してください。 これによって、他のユーザはこのパスワードを見つけ出すことができなくなります）。使用する全てのクライアントプログラムに認識されない限り、[client]グループにオプションを入れないようにしてください。オプションを解読しないプログラムは、オプションを実行しようとすればエラーメッセージを表示した後に中断されます。

次に示されているのは典型的なグローバルオプションファイルです。

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

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

[mysqldump]
quick

上のオプションファイルは、key_buffer_sizeとmax_allowed_packetの変数をセットするラインのためにvar_name=value構文を使用します。

ここに典型的なユーザオプションファイルがあります。

[client]
# The following password will be sent to all standard MySQL clients
password="my_password"

[mysql]
no-auto-rehash
connect_timeout=2

[mysqlhotcopy]
interactive-timeout

特定のMySQLリリースシリーズのmysqldサーバのみによって解読されるオプショングループを作りたければ、[mysqld-5.0]、[mysqld-5.1]などの名前を備えたグループの使用により可能になります。次のグループは次のことを示します--newオプションは5.1.xバージョン番号を持ったMySQLサーバによってのみ使用される必要があります。

[mysqld-5.1]
new

MySQL 5.0.4から始め、オプションファイルを求めて特定のディレクトリを探索する他のオプションファイル、および!includedirを含むようにオプションファイルの中で!include指令を使用することができます。例えば、/home/mydir/myopt.cnfファイルを含むためには次の指令を使用することができます。

!include /home/me/myopt.cnf

/home/mydirディレクトリを探し出し、見つかったオプションファイルを解読するためにはこの指令を使います。

!includedir /home/mydir

注記 :一般的に、Unixオペレーティングシステム上で見つけることができ、!includedir指令の使用が含まれているファイルの全てが、.cnfで終わるファイル名を持っていなければいけません。Windowsにおいては、この指令が.iniか.cnf拡張を備えたファイルをチェックします。

付属のファイルから解読されたオプションは、一般的なオプショングループのコンテキストに適用されることに注意してください。my.cnfに次のラインを書かなければならないと仮定してください。

[mysqld]
!include /home/mydir/myopt.cnf

この場合、myopt.cnfファイルはサーバ用にのみ処理されます。 また、!include指令は全てのクライアントアプリケーションによって無視されます。しかし、次のラインを使用したならば、ディレクトリ/home/mydir/my-dump-optionsは、サーバによって、あるいは他のクライアントアプリケーションによってではなく、mysqldumpのみによってオプションファイルのチェックが行われます。

[mysqldump]
!includedir /home/mydir/my-dump-options

ソース分配を持っていれば、support-filesディレクトリ中にmy-xxxx.cnfという名前のサンプルオプションファイルが見つかります。バイナリ分配の場合は、MySQLインストールディレクトリの下でsupport-filesディレクトリの中を見てください。Windowsにおいては、サンプルオプションファイルはMySQLインストールディレクトリに置かれていることがあります（この章の前半、どこのことか分からない場合には章?2. MySQL のインストールと更新を参照してください)。一般的に、小さな、ミディアム、大きな、また大規模システムのためのサンプルオプションファイルがあります。これらのファイルのうちのひとつで実験するには、Windows上でC:\my.cnfに、あるいはUnix上のホームディレクトリ中にある.my.cnfにコピーしてください。

注記 :Windowsにおいては、.cnfか.iniオプションファイル拡張が表示されない可能性があります。

オプションファイルをサポートするMySQLプログラムは全て、次のオプションを扱い、オプションファイル取り扱いに影響します。したがって、これらはオプションファイル中でではなくコマンドライン上で与えられる必要があります。適切な動作のためには、これらのオプションの各々は速やかにコマンド名に続かなければなりません。 ここでの例外として、--print-defaultsは--defaults-fileまたは--defaults-extra-file直後に使用することができます。また、望み通りに解釈されないかもしれないので、ファイル名を指定する場合‘~’シェルメタ文字の使用は回避するべきです。

シェルスクリプトでは、オプションファイルを解析するmy_print_defaultsプログラムを使用し、オプションが与えられたプログラムによって何に使用されるか確かめることができます。次の例は、[client]および[mysql]グループで見つかったオプションを表示するように依頼された時、my_print_defaultsによって生産される可能性のある出力を示しています。

shell> my_print_defaults client mysql
--port=3306
--socket=/tmp/mysql.sock
--no-auto-rehash

開発者への注意:オプションファイル取り扱いは、単純に適切なグループ中で、または任意のコマンドライン引数の前でオプションを全て処理することにより、Cクライアントライブラリで実行されます。複数回指定されるオプションの最後のインスタンスを使用するプログラムにとって、これは有効な方法です。複数回指定されるオプションをこの方法で扱うが、オプションファイルを解読しないCまたはC++のプログラムを持っている場合、この機能を使えるようにするためにはたった2行のラインを加えればよいだけです。この方法を確認するには、スタンダードMySQLクライアントのうちのいずれかのソースコードをチェックしてください。

MySQLへの他の言語インターフェースのうちのいくつかはCクライアントライブラリに基づいています。 またその中には、オプションファイルのコンテンツへアクセス方法が提供されているものもあります。これらはPerlとPythonを含んでいます。詳細については、手持ちのインターフェースにとって好ましい使用説明を参照してください。

環境変数を使用してオプションを指定するためには、コマンド処理プログラムに適切な構文を使用し、変数をセットしてください。例えば、WindowsまたはNetWareにおいては、USER変数にMySQLアカウント名を指定させることができます。そのためには、次の構文を使用してください。

SET USER=your_name

Unixの上の構文はユーザのシェルに依存します。MYSQL_TCP_PORT変数を使用してTCP/IPポート番号を指定すると仮定してください。典型的な構文（sh、bash、zshなど）は、以下の通りです。

MYSQL_TCP_PORT=3306
export MYSQL_TCP_PORT

最初のコマンドが変数を設定し、また、exportコマンドがシェル環境に変数を輸出することによって、その値がMySQLおよび他のプロセスにアクセス可能になるようになります。

cshとtcshについては、シェル変数を環境を利用可能にするためにsetenvを使用してください。

setenv MYSQL_TCP_PORT 3306

環境変数をセットするコマンドは効果を直ちに現わすため、ユーザのコマンドプロンプトで実行することができます。 しかし、このセッティングはログアウトするまでしか続きません。このセッティングがログインごとに効果を発揮するようにするためには、コマンドインタープリタが毎回起動時に解読するスタートアップファイルに適切なコマンド（複数可）を置きます。典型的なスタートアップファイルは、Windows用のAUTOEXEC.BAT、bash用の.bash_profileあるいはtcsh用の.tcshrcです。詳細についてはコマンドインタープリタについての使用説明を参照してください。

項2.14. 「環境変数」にはMySQLプログラムオペレーションに影響する環境変数が全てリストアップされています。

MySQLプログラムの多くがランタイムでセットすることができる内部変数を持っています。プログラム変数は、値をとる他の長いオプションと同じ方法を課されます。例えば、mysqlは、そのコミュニケーションバッファの最大サイズをコントロールするmax_allowed_packet変数を持っています。mysqlのために16MBの値に max_allowed_packet変数をセットするためには、下記コマンドのどちらかを使用してください。

shell> mysql --max_allowed_packet=16777216
shell> mysql --max_allowed_packet=16M

第1のコマンドはバイトで値を指定します。第2はメガバイトで値を指定します。数値の値をとる変数については、値は、1024、1024²乗または1024³乗、それぞれの乗数を示すために、K、MあるいはG(大文字か小文字のいずれか)の接尾辞で与えることができます。(例えば、max_allowed_packetをセットするために使用された時、接尾辞はキロバイト、メガバイトあるいはギガバイトのユニットを示します)。

オプションファイルでは、可変セッティングが主要なダッシュなしで与えられます。

[mysql]
max_allowed_packet=16777216

または :

[mysql]
max_allowed_packet=16M

好みによって変数名中の下線はダッシュとして指定することができます。次のオプショングループは等価です。共に512MBにサーバの重要なバッファのサイズをセットします。

[mysqld]
key_buffer_size=512M

[mysqld]
key-buffer-size=512M

注記 :MySQL 4.0.2以前は、セットするプログラム変数用の唯一の構文は--set-variable=option=value（あるいはオプションファイル中のset-variable=option=value）でした。この構文はまだ存在しますが、MySQL 4.0.2でもクレームが多いものです。

サーバシステム変数の多くはまた、ランタイムでもセットすることができます。詳細は、項4.2.4.2. 「動的システム変数」 をご覧ください。