無料PHPプログラム

テーブル名の後にカンマで区切られたカラム名のリストを提供する事ができます。この場合、名前が付けられた各カラムの値には VALUES リストか SELECT ステートメントが与えられなければいけません。

もし INSERT ... VALUES か INSERT ... SELECT にカラム名のリストを指定しなければ、VALUES リストか SELECT ステートメントがテーブル内全てのカラムの値を提供する必要があります。もしテーブル内のカラムの順番がわからなければ、それを見つける為に DESCRIBE tbl_name を利用してください。

SET 条項はカラム名を明示的に指示します。

もしストリクト SQL モードを利用していない場合、値を明示的に与えられていないカラムはそのデフォルト値（明示的、または暗黙の）に設定されます。例えば、もしテーブル内の全てのカラムに名前を付けないカラムのリストを指定すると、名づけられていないカラムはそのデフォルト値に設定されます。デフォルト値の割り当てについては 項10.1.4. 「データタイプデフォルト値」 で説明しています。項1.8.6.2. 「無効値の制約」 もご参照ください。

もし、デフォルト値を持たない全てのカラムの値を明示的に指定しない限りエラーを発生させる INSERT ステートメントが必要であれば、ストリクト モードを利用する必要があります。詳しくは 項4.2.6. 「SQL モード」 を参照してください。

明示的にカラムをそのデフォルト値に設定するには、キーワード DEFAULT を利用してください。これはテーブル内の各カラムの値を持たない不完全な VALUES リストの書き込みを防ぐ事ができるので、一部を除く全てのカラムに値を割り当てる INSERT ステートメントの書き込みを簡単にします。そうでなければ、VALUES リスト内のそれぞれの値に対応するカラム名のリストを書かなければいけません。

また、与えられたカラムのデフォルト値を生成する式の中で利用されるより一般的な形として、DEFAULT(col_name) を利用する事もできます。

もしカラム リストと VALUES リストの両方が空なら、INSERT は各カラム セットを利用してそのデフォルト値に行を作成します。

INSERT INTO tbl_name () VALUES();

ストリクト モードでは、もしどのカラムもデフォルト値を持っていなければエラーが発生します。そうでなければ、MySQL は明示的に指定されたデフォルト値を持たない全てのカラムに対して暗黙のデフォルト値を利用します。

カラム値を提供する為に expr 式を指定する事ができます。もし式のタイプがカラムのタイプに合わなければ、タイプの変換が行われる可能性があり、そしてデータのタイプによっては、与えられた値の変換が別の挿入値を生み出す事があります。例えば、文字列 '1999.0e-2' を、INT、FLOAT、DECIMAL(10,6)、または YEAR カラムに挿入すると、それぞれ 1999、19.9921、19.992100、そして 1999 が挿入される事になります。INT と YEAR カラムに格納された値が 1999 である理由は、文字列から整数への変換時には、文字列の最初の部分の、有効な整数や年として判断される部分だけを見るからです。浮動小数点と固定小数点カラムに対しては、文字列から浮動小数点への変換時には、文字列全体を有効な浮動小数点として判断します。

expr 式は、値のリストに早いうちに設定された全てのカラムを参照する事ができます。例えば、col2 の値は、既に割り当てられた col1 を参照する事ができるので、上記のような事が可能なのです。

INSERT INTO tbl_name (col1,col2) VALUES(15,col1*2);

しかし、col1 の値は、col1 の後で割り当てられた col2 を参照する為、次のような物は正当ではありません。

INSERT INTO tbl_name (col1,col2) VALUES(col2*2,15);

1つの例外が AUTO_INCREMENT 値を持つカラムに関係しています。別の値の割り当て後に AUTO_INCREMENT 値が発生するので、その割り当ての中での AUTO_INCREMENT カラムへの参照は 0 を返すのです。

NOT NULL を宣言していたカラムに NULL を挿入する。複合行 INSERT ステートメントや INSERT INTO ... SELECT ステートメントに対しては、カラムはカラム データ タイプの暗黙のデフォルト値に設定されます。数値タイプ、文字列タイプの空の文字列('')、そして日付、時間タイプの 「ゼロ」 値に対してのこの値は 0 です。サーバは単列を戻すかどうかを確認する為に SELECT からの結果セットを検査しない為、INSERT INTO ... SELECT ステートメントは複合行挿入と同じ方法で扱われます。(単列 INSERT に対しては、NULL が NOT NULL カラムに挿入された時、警告は発生しません。代わりに、ステートメントはエラーになり失敗します。)

数値カラムを、範囲外の値に設定する。値はその範囲の終点に一番近いところでクリップされます。

数値カラムに '10.34 a' のような値を割り当てる。後続の非数値テキストは取り除かれ、残りの数値部分が挿入されます。もし文字列値がその最初の部分に数値を持たない場合は、そのカラムは 0 に設定されます。

文字列を、カラムの最大長さを上回る文字列カラムに (CHAR、VARCHAR、TEXT、または BLOB)挿入する。値はカラムの最大長さまで切り捨てられます。

日付や時間カラムに不正である値を挿入する。カラムはそのタイプにとって適正であるゼロの値に設定されます。

もし DELAYED キーワードを利用すると、サーバはバッファに挿入される行を置くので、INSERT DELAYED ステートメントを発行するクライアントは即座に再開されます。もしテーブルが使用中であれば、サーバが行を保持します。テーブルがフリーであればサーバは行の挿入を始め、新しいリクエストがないかを調べる為に定期的にテーブルを確認します。もしあれば、遅れた行の列はテーブルが再度フリーになるまでサスペンドされます。項12.2.4.2. 「INSERT DELAYED 構文」 を参照してください。

サーバは、INSERT ... SELECT か

INSERT ... ON DUPLICATE KEY UPDATE に対して

DELAYED を無視します。

もし LOW_PRIORITY キーワードを利用すると、別のクライアントがテーブルからの読み込みをしなくなるまで、INSERT の実行が遅れます。これには、既存クライアントが読み込みをしている最中、そして INSERT LOW_PRIORITY ステートメントが待っている最中に読み込みを始めてしまう別のクライアントが含まれます。しかし、INSERT LOW_PRIORITY ステートメントを発行するクライアントがリード ヘビー環境の中で長時間（または永遠に）待つ事は可能です。(これは、クライアントにそのまま作業を続けさせる INSERT DELAYED とは逆の機能です。並列挿入ができなくなるので、通常 LOW_PRIORITY は MyISAM テーブルと一緒には利用されません。詳しくは 項6.3.3. 「同時挿入」 を参照してください。

もし HIGH_PRIORITY を指定すると、サーバが --low-priority-updates オプションでスタートされている場合その効果が無効になります。また、並行挿入も利用されなくなります。

もし IGNORE キーワードを利用したら、INSERT ステートメントの実行中に起きたエラーは警告として扱われます。例えば、IGNORE が無いと、テーブル内に既存の UNIQUE インデックスや PRIMARY KEY 値を複製する行に複製キー エラーが起き、そのステートメントは異常終了されます。IGNORE を利用すると、行の挿入はされませんが、エラーも発行されません。もし IGNORE が指定されなければ、データ変換はステートメントに関するエラーを引き起こします。IGNORE を利用すると、不正な値は一番近い値に調節されて挿入され、警告が発生されますがステートメントは異常終了しません。いくつのテーブルが実際に挿入されたのか、mysql_info() C API 関数を利用して調べる事ができます。

もし ON DUPLICATE KEY UPDATE を指定し、UNIQUE インデックスか PRIMARY KEY 内で複製値を引き起こす行が挿入されると、古い行の UPDATE が実行されます。詳しくは 項12.2.4.3. 「INSERT ... ON DUPLICATE KEY UPDATE 構文」 を参照してください。