いくつかの機能を除いて --optの効果を選択したい場合、除きたい各機能に対して--skipオプションを選択してください。たとえば、拡張挿入を無効にし、メモリーバッファリングを有効にするには、--opt --skip-extended-insert --skip-quick を使用します。(MySQL 5.1 以降のバージョンでは、--opt がデフォルトで有効になっているため、--skip-extended-insert --skip-quick で十分です。)

インデックスの無効化とテーブルのロックを除くすべての機能に対して --opt を反転するには、--skip-opt --disable-keys --lock-tables を使用します。

--help, -?

ヘルプメッセージを表示し、閉じます。

--add-drop-database

DROP DATABASE ステートメントを CREATE DATABASE ステートメントの前に追加します。

--add-drop-table

DROP TABLE ステートメントを CREATE TABLE ステートメントの前に追加します。

--add-locks

LOCK TABLES と UNLOCK TABLES ステートメントで各テーブルダンプを囲みます。ダンプファイルを再ロードする際のインサートの速度が向上します。項4.2.21. 「INSERT ステートメントの速度」 を参照してください。

--all-databases, -A

すべてのデータベース内のすべてのテーブルをダンプします。これは--databasesオプションを使用してコマンドラインですべてのデータベース名を指定するのと同じです。

--all-tablespaces, -Y

テーブルダンプに、NDBCLUSTER テーブルで使用されるテーブル領域の作成に必要なすべての SQL ステートメントを追加します。でなければ、この情報は mysqldump の出力には含まれていません。このオプションは、現在 MySQL Cluster テーブルに対してのみ有効です。

このオプションは MySQL 5.1.6 で追加されました。

--allow-keywords

キーワードであるカラム名の作成を許容します。これは各カラム名の接頭辞にテーブル名を用いることで可能になります。

--character-sets-dir=path

キャラクタセットがインストールされるディレクトリです。Character Set Configuration を参照してください。

--comments, -i

プログラムバージョン、サーバーバージョンやホストといった追加情報をダンプファイルに書き込みます。このオプションはデフォルトで有効となっています。追加情報を抑制するには、--skip-commentsを使用してください。

--compact

詳細出力を少なくします。このオプションは、--skip-add-drop-table、--skip-add-locks、--skip-comments、--skip-disable-keys、および --skip-set-charset オプションを有効にします。

--compatible=name

古い MySQL サーバーやほかのデータベースシステムと互換性のある出力を生成します。name の値は ansi、mysql323、mysql40、postgresql、oracle、mssql、db2、maxdb、no_key_options、no_table_options、あるいは no_field_options となります。複数の値を使用する場合カンマで離してください。これらの値はサーバー SQL モードの設定用の対応しているオプションと同じ意味を持っています。Server SQL Modes を参照してください。

このオプションはほかのサーバーとの互換性を保証するものではありません。現在提供されている、ダンプ出力の互換性を挙げるための SQL モード値を有効にするだけです。たとえば、--compatible=oracleはデータ型を Oracle 型にマップしたり、Oracle コメント構文を使用したりしません。

このオプションには、バージョン 4.1.0 以降のサーバーが必要です。それよりも古いサーバーでは、何も行われません。

--complete-insert, -c

カラム名を含んだ、完全な INSERT ステートメントを使用します。

--compress, -C

双方が圧縮をサポートしている場合、クライアント・サーバー間で行きかう情報をすべて圧縮します。

--create-options

MySQL 独特のオプションを CREATE TABLE ステートメントに含みます。

--databases, -B

複数のデータベースをダンプします。通常、mysqldump はコマンドライン上の最初の引数名とそれに続く名をテーブル名として認識します。このオプションを使用するうことで、名前のついた引数をすべてデータベース名として認識します。CREATE DATABASE や USE ステートメントは新しいデータベースの前の出力に含まれています。

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

デバッグのログを書き込みます。debug_options 文字列は通常 'd:t:o,file_name' になります。デフォルト値は 'd:t:o,/tmp/mysqldump.trace' です。

--debug-check

プログラムが閉じるときに、デバッグ情報をプリントします。このオプションは MySQL 5.1.21 で追加されました。

--debug-info

プログラムの終了時にデバッグ情報と、メモリーおよび CPU 使用率の統計を表示します。このオプションは MySQL 5.1.14 で追加されました。

--default-character-set=charset_name

charset_name をデフォルトキャラクタセットとして使用します。詳しくはCharacter Set Configurationを参照してください。キャラクタセットが指定されていない場合、mysqldump では utf8 を使用し、以前のバージョンでは latin1 を使用します。

MySQL 5.1.38 より前のバージョンでは、このオプションは --tab オプションを使用して生成された出力データファイルには効果がありません。そのオプションの説明を参照してください。

--delayed-insert

INSERT ステートメントよりも INSERT DELAYED ステートメントを書き出します。

--delete-master-logs

マスタレプリケーションサーバーで、ダンプを実行後バイナリログを消去します。このオプションは自動的に--master-dataを有効にします。

--disable-keys, -K

テーブルごとに INSERT ステートメントを /*!40000 ALTER TABLE tbl_name DISABLE KEYS */; ステートメントと /*!40000 ALTER TABLE tbl_name ENABLE KEYS */; ステートメントで囲みます。行がすべて挿入されたあとにインデックスが作成されるため、ダンプファイルのロードが早くなります。このオプションは、MyISAM テーブルの一意でないインデックスにのみ効果があります。

--dump-date

--comments オプションが指定されている場合、mysqldump はダンプの最後に -- Dump completed on DATE コメントを生成します。ただし、この日付によって、異なる時間に取得された同一データのダンプファイルが違っているように見えます。--dump-date と --skip-dump-date は、日付をコメントに追加するかどうかを制御します。デフォルトは --dump-date (日付をコメントに含める) です。--skip-dump-date は日付の表示を抑止します。このオプションは MySQL 5.1.23 で追加されました。

--events, -E

ダンプされたデータベースからイベントをダンプします。このオプションは MySQL 5.1.8.で追加されました。

--extended-insert, -e

複数の VALUES リストを含む、複数行 INSERT 構文を使用してください。これにより、ダンプファイルサイズを小さくし、ファイルが再ロードされる際の挿入スピードがあがります。

--fields-terminated-by=..., --fields-enclosed-by=..., --fields-optionally-enclosed-by=..., --fields-escaped-by=...

これらのオプションは-Tオプションと共に使用され、LOAD DATA INFILE に対応する節と同じ意味があります。項8.2.6. 「LOAD DATA INFILE 構文」 を参照してください。

--first-slave, -x

非推奨。現在では --lock-all-tables という名前に変更されています。

--flush-logs, -F

ダンプを始める前に MySQL サーバーログファイルをフラッシュします。このオプションは RELOAD 権限を要求します。このオプションを--all-databases (あるいは-A) オプションと併用した場合、ログはダンプされたデータベースごとにフラッシュされます。例外は、--lock-all-tablesまたは--master-dataを使用しているときです。この場合、ログはすべてのテーブルがロックされた瞬間に一度だけフラッシュされます。ログのフラッシュとダンプを同時に行いたい場合、--flush-logsを--lock-all-tablesや--master-dataと併用してください。

--flush-privileges

mysql データベースのダンプ後、.FLUSH PRIVILEGES ステートメントを発行してください。このオプションはダンプに mysql データベースが含まれている場合と、正しい復元のために mysql データベース内に含まれているデータに依存するデータベースが含まれている場合に使用するべきです。このオプションは MySQL 5.1.12.で追加されました。

--force, -f

テーブルダンプの最中に SQL エラーが発生しても続行します。

このオプションの使い方の 1 つとして、mysqldump は、無効になっているビュー (削除されたテーブルをビュー定義が参照するため) を検出したときにも実行を続けます。--forceなしでは、mysqldump はエラーメッセージを発し閉じます。--force を使用すると、mysqldump はエラーメッセージを出力しますが、さらにビュー定義を含む SQL コメントをダンプ出力に書き込み、実行を継続します。

--host=host_name, -h host_name

与えられたホスト上で MySQL サーバーからデータをダンプします。デフォルト設定では、localhost がホストになります。

--hex-blob

16 進変換表記法を使用しているバイナリカラムをダンプします (たとえば、'abc'は 0x616263 となります)。影響を受けるデータ型は BINARY、VARBINARY、BLOB、そして BIT になります。

--ignore-table=db_name.tbl_name

データベースとテーブル名の両方を使用して特定されなければいけないテーブルをダンプしないでください。複数テーブルを無視するには、このオプションを複数回使用してください。このオプションを使用してビューを無視することもできます。

--insert-ignore

INSERT ステートメントを IGNORE オプションで書いてください。

--lines-terminated-by=...

これらのオプションは-Tオプションと共に使用され、LOAD DATA INFILE に対応する節と同じ意味があります。項8.2.6. 「LOAD DATA INFILE 構文」 を参照してください。

--lock-all-tables, -x

データベース内のテーブルをすべてロックします。これは全ダンプの期間、グローバル読み取りロックを取得することで達成されます。このオプションは自動的に--single-transactionと--lock-tablesをオフにします。

--lock-tables, -l

ダンプする前にすべてのテーブルをロックします。テーブルは READ LOCAL でロックされ、これにより MyISAM テーブルの場合同時インサートが許容されます。InnoDB といったトランザクションテーブルには、--single-transactionはテーブルをロックする必要がないため、はるかにいいオプションです。

複数データベースをダンプする際は、--lock-tablesは各データベースのテーブルを個別にロックします。よって、このオプションはダンプファイル内のテーブルがデータベース間で矛盾していないことを保証するわけではありません。異なるデータベース内のテーブルは完全に異なるステートでダンプされることがあります。

--log-error=file_name

警告やエラーを名前付きファイルに追加します。このオプションは MySQL 5.1.18 で追加されました。

--master-data[=value]

マスターレプリケーションサーバーをダンプして、別のサーバーをマスターのスレーブとして設定するために使用できるダンプファイルを生成する場合にこのオプションを使用します。これにより、ダンプされたサーバーのバイナリログ座標 (ファイル名とファイル位置) を示す CHANGE MASTER TO ステートメントがダンプ出力に追加されます。これらは、スレーブがレプリケーションを開始するマスターサーバーの座標です。

オプションの値が 2 の場合、CHANGE MASTER TO ステートメントは SQL コメントとして書き込まれるため、情報提供の意味しかなく、ダンプファイルが再ロードされるときに効果がありません。オプションの値が 1 の場合、このステートメントはダンプファイルが再ロードされるときに有効になります。オプションの値を指定しない場合、デフォルト値は 1 となります。

このオプションは RELOAD 権限を要求し、バイナリログが有効にされていなければいけません。

--master-dataオプションは自動的に--lock-tablesをオフにします。また、--single-transaction が指定されていなければ、--lock-all-tables を有効にします。その場合、ダンプの最初のほんのわずかな時間でグローバル読み取りロックが取得されます (--single-transaction の説明を参照)。どの場合でも、ログに対するアクションはすべてダンプと同時に発生します。

マスターの既存のスレーブをダンプすることで、スレーブを設定することもできます。このためには、既存のスレーブで次の手順を実行します。

--no-autocommit

ダンプされたテーブルごとに INSERT ステートメントを SET autocommit = 0 ステートメントと COMMIT ステートメントで囲みます。

--no-create-db, -n

このオプションは--databasesや--all-databasesオプションが提供されていた場合、出力に含まれる CREATE DATABASE ステートメントを抑制します。

--no-create-info, -t

各ダンプされたテーブルを再作成する CREATE TABLE ステートメントを書かないでください。

--no-data, -d

テーブル行情報を書かないでください (つまりテーブル内容をダンプしないでください)。これはテーブルの CREATE TABLE ステートメントのみをダンプしたい場合に非常に便利です。

--no-set-names

このオプションは推奨されません。代わりに --skip-set-charset を使用してください。instead.

--opt

このオプションは短縮形であり、--add-drop-table --add-locks --create-options --disable-keys --extended-insert --lock-tables --quick --set-charset を指定したのと同じです。速いダンプオプレーションを提供し、MySQL サーバーにすばやく再ロードできるダンプファイルを生成します。

--opt オプションはデフォルトで有効になっています。このオプションを無効にするには、--skip-opt を使用します。--opt によって影響を受けるオプションの一部を選択して有効または無効にする方法については、この節の最初の説明を参照してください。

--order-by-primary

各テーブルの行をその主キーまたはその最初の一意のインデックス (そのようなインデックスが存在する場合) でソートします。これは、InnoDB テーブルにロードする MyISAM テーブルをダンプしているときに便利ですが、ダンプに要する時間がかなり伸びます。

--password[=password], -p[password]

サーバーに接続する際に使用するパスワードです。ショートオプションフォーム (-p) を使用した場合、オプションとパスワードの間にスペースを置くことはできません。コマンドライン上で--password あるいは-pに続くオプションから password 値を取り除いた場合、パスワード値を求められます。

コマンドライン上でのパスワードの特定は安全ではありません。End-User Guidelines for Password Security を参照してください。

--pipe, -W

Windows では、名前付きパイプを介してサーバーに接続します。このオプションは、ローカルサーバーへの接続で、サーバーが名前付きパイプ接続をサポートしている場合にのみ適用されます。

--port=port_num, -P port_num

接続に使用する TCP/IP ポート番号です。

--protocol={TCP|SOCKET|PIPE|MEMORY}

サーバーへの接続に使用する接続プロトコルを指定します。このオプションは、ほかの接続パラメータによって、必要なプロトコル以外のものが通常使用される場合に役立ちます。使用できる値の詳細は、Connecting to the MySQL Serverを参照してください。

--quick, -q

このオプションは大きなテーブルのダンプに便利です。これにより、mysqldump は全結果セットを取得、メモリー内でバッファー後表示といった一連の作業を一気にこなさず、サーバーから 1 行ずつ結果を取得します。

--quote-names, -Q

データベース名、テーブル名、およびカラム名を 「`」 文字で囲みます。ANSI_QUOTES SQL モードが有効になっている場合、名前は 「"」 文字で囲まれます。このオプションはデフォルトで有効となっています。--skip-quote-namesで無効化することもできますが、このオプションは--compatibleのような--quote-namesを有効にするオプションの後に与えられるべきです。

--replace

INSERT ステートメントよりも REPLACE ステートメントを書き出します。MySQL 5.1.3.より提供されています。

--result-file=file_name, -r file_name

提供されているファイルに出力を導きます。このオプションは、Windows 上で改行文字 「\n」 が復帰改行/改行シーケンス 「\r\n」 に変換されないようにするために使用します。ダンプ生成中にエラーが発生しても、結果ファイルは作成され、内容は上書きされます。以前の内容は失われます。

--routines, -R

ストアドルーチン (プロシージャーやファンクション) をダンプされたデータベースからダンプします。このオプションの使用は mysql.proc テーブルのための SELECT 権限を要求します。--routinesを使用して生成された出力はルーチンの再作成のため、CREATE PROCEDURE と CREATE FUNCTION ステートメントを含んでいます。ただし、これらのステートメントはルーチン作成や改良タイムスタンプといった属性を含んでいません。つまりルーチンが再ロードされたとき、再ロードに要した時間と等価のタイムスタンプで作成されます。

ルーチンを元のタイムスタンプ属性で再作成しなければいけない場合、--routinesを使用しないでください。代わりに、mysql データベースの正しい権限を持っている MySQL アカウントを使用して mysql.proc テーブルの内容を直接ダンプ、再ロードしてください。

このオプションは MySQL 5.1.2.で追加されました。これ以前では、記憶されたルーチンはダンプされませんでした。ルーチン DEFINER 値は MySQL 5.1.8.までダンプされませんでした。つまり、5.1.8,以前でルーチンが再ロードされた場合、再ロードユーザーに設定された定義子で作成されます。元の定義子でルーチンを再作成しなければいけない場合、mysql.proc テーブルの内容を、以前説明したとおりに、直接ダンプしロードしてください。

--set-charset

出力に SET NAMES default_character_set を追加します。このオプションはデフォルトで有効となっています。SET NAMES ステートメントを抑制するには、--skip-set-charsetを使用してください。

--single-transaction

このオプションはサーバーからデータをダンプする前に BEGIN SQL ステートメントを発行します。InnoDB といったトランザクションテーブルに対してのみ便利です。なぜなら、アプリケーションをブロックせずに、BEGIN が発行された当時のデータベースの状態をダンプするからです。

このオプションを使用しているときは、一定の状態でダンプされるのは InnoDB テーブルのみだということを留意してください。たとえば、このオプションを使用中にダンプされた MyISAM や MEMORY テーブルは状態が変化する可能性があります。

--single-transaction ダンプの処理中に、有効なダンプファイル (正しいテーブル内容とバイナリログ位置) を保証するには、ほかの接続で ALTER TABLE、DROP TABLE、RENAME TABLE、TRUNCATE TABLE の各ステートメントを使用しないようにします。一貫性のある読み取りはそれらのステートメントと切り離すことはできないので、ダンプされるテーブルでそれらのステートメントを使用すると、テーブル内容を取り出すために mysqldump で実行される SELECT が間違った内容を取得したり、失敗したりする可能性があります。

このオプションは MySQL Cluster テーブルではサポートされていません。つまり、NDBCLUSTER ストレージエンジンは READ_COMMITTED トランザクション遮断レベルしかサポートしていないため、結果が一貫している保証がありません。代わりに、必ず NDB のバックアップと復元を使用するようにしてください。

--single-transactionオプションと--lock-tablesは互いに関連していません。これは、LOCK TABLES が待機中のトランザクションを必然的にコミットさせるからです。

大きなテーブルをダンプするには、このオプションを--quickと併用してください。

--skip-comments

--commentsオプションの詳細を参照してください。

--skip-opt

--optオプションの詳細を参照してください。

--socket=path, -S path

localhost の接続用に使用する、UNIX ではソケットファイル、Windows では使用する名づけられたパイプ。

--ssl*

--sslで始まるオプションは、SSL を介してサーバーに接続し、SSL キーや証明の場所を明示するか否かを指定します。SSL Command Options を参照してください。

--tab=path, -T path

タブによって分けられたデータファイルを生成します。各ダンプされたテーブルごとに、mysqldump はテーブルを作成する CREATE TABLE ステートメントを含むtbl_name.sql ファイルと、そのデータを含むtbl_name.txt ファイルを作成します。オプション値はファイルを書き込むディレクトリです。

デフォルトで、.txt データファイルはカラム値と、各行の最後で新しいラインの間にタブキャラクタを使用してフォーマットされます。このフォーマットは明示的に--fields-xxxと--lines-terminated-byオプションを使用することで特定することができます。

MySQL 5.1.38 以降のバージョンでは、カラム値は --default-character-set オプションで指定されたキャラクタセットに変換されて書き込まれます。MySQL 5.1.38 よりも前のバージョンまたはそのようなオプションが存在しない場合、値はバイナリキャラクタセットを使用してダンプされます。実際には、キャラクタセットの変換はありません。1 つのテーブルにさまざまなキャラクタセットのカラムが含まれている場合、出力データファイルも同様なため、そのファイルを正しく再ロードできないことがあります。

--tables

--databases オプションまたは -B オプションを上書きします。mysqldump は、このオプションに続く名前の引数をすべてテーブル名と見なします。

--triggers

ダンプされたテーブルごとにトリガーをダンプします。このオプションはデフォルトで有効にされています。--skip-triggersを使用して無効化してください。

--tz-utc

このオプションにより、TIMESTAMP カラムは異なるタイムゾーンのサーバー間でダンプおよび再ロードできるようになります。mysqldump はその接続タイムゾーンを UTC に設定し、SET TIME_ZONE='+00:00' をダンプファイルに追加します。このオプションなしでは、TIMESTAMP カラムはソースとデスティネーションサーバーのタイムゾーンにダンプ・再ロードされ、値が変わる場合があります。--tz-utcはサマータイムによる時間の変更に対してもプロテクトします。--tz-utcはデフォルトで有効にされています。無効化するには、--skip-tz-utcを使用してください。このオプションは MySQL 5.1.2.で追加されました。

--user=user_name, -u user_name

サーバーへの接続時に使用する MySQL ユーザー名です。

--verbose, -v

冗長モード。プログラム実行に関する情報を出力する。

--version, -V

バージョン情報を表示し、閉じます。

--where='where_condition', -w 'where_condition'

ある WHERE 状態に選択された行のみダンプします。ユーザーのコマンドインタープリタにとって特別なキャラクタ、またはスペースを含んでいる場合、状態の周りをクオートで囲まなければいけません。

例:

--where="user='jimf'"
-w"userid>1"
-w"userid<1"

--xml, -X

ダンプ出力と、well-formed XML も書き出します。

NULL、'NULL'、および空の値: column_name という名前のカラムの場合、NULL 値、空の文字列、および文字列値 'NULL' はこのオプションによって生成される出力では次のように区別されます。

MySQL 5.1.12 に始まり、--xmlオプションを使用しているときの mysql クライアントもこれらの規則を守ります。(詳しくは 項3.1.1. 「mysql オプション」 を参照してください。)

MySQL 5.1.18 以降のバージョンでは、次に示すように、mysqldump の XML 出力には XML 名前空間が含まれます。

shell> mysqldump --xml -u root world City
<?xml version="1.0"?>
<mysqldump xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<database name="world">
<table_structure name="City">
<field Field="ID" Type="int(11)" Null="NO" Key="PRI" Extra="auto_increment" />
<field Field="Name" Type="char(35)" Null="NO" Key="" Default="" Extra="" />
<field Field="CountryCode" Type="char(3)" Null="NO" Key="" Default="" Extra="" />
<field Field="District" Type="char(20)" Null="NO" Key="" Default="" Extra="" />
<field Field="Population" Type="int(11)" Null="NO" Key="" Default="0" Extra="" />
<key Table="City" Non_unique="0" Key_name="PRIMARY" Seq_in_index="1" Column_name="ID" Collation="A" Cardinality="4079"
Null="" Index_type="BTREE" Comment="" />
<options Name="City" Engine="MyISAM" Version="10" Row_format="Fixed" Rows="4079" Avg_row_length="67" Data_length="27329
3" Max_data_length="18858823439613951" Index_length="43008" Data_free="0" Auto_increment="4080" Create_time="2007-03-31 01:47:01" Updat
e_time="2007-03-31 01:47:02" Collation="latin1_swedish_ci" Create_options="" Comment="" />
</table_structure>
<table_data name="City">
<row>
<field name="ID">1</field>
<field name="Name">Kabul</field>
<field name="CountryCode">AFG</field>
<field name="District">Kabol</field>
<field name="Population">1780000</field>
</row>
...
<row>
<field name="ID">4079</field>
<field name="Name">Rafah</field>
<field name="CountryCode">PSE</field>
<field name="District">Rafah</field>
<field name="Population">92020</field>
</row>
</table_data>
</database>
</mysqldump>

max_allowed_packet

クライアント/サーバー通信用のバッファーの最大サイズ。最大値は 1G バイトです。

net_buffer_length

クライアント/サーバー通信用のバッファーの初期サイズ。複数行挿入ステートメントの作成時 (オプション --extended-insert や --opt と同様)、mysqldump は net_buffer_length の長さまで行を作成します。この変数を増やした場合、MySQL サーバー内の net_buffer_length 変数も最低同じ大きさでなければいけません。