デフォルト値

データ型仕様のDEFAULT値句は、列のデフォルト値を示します。

すべてのデータ型にデフォルト値を設定できます。通常、デフォルト値は定数である必要があり、関数や式にすることはできませんが、例外がいくつかあります。

• 時間型の場合、 TIMESTAMPとDATETIME列のデフォルト値としてNOW 、 CURRENT_TIMESTAMP 、 LOCALTIME 、およびLOCALTIMESTAMP関数を使用できます。
• 整数型の場合、 NEXT VALUE FOR関数を使用してシーケンスの次の値を列のデフォルト値として設定し、 RAND()関数を使用してランダムな浮動小数点値を列のデフォルト値として生成できます。
• 文字列型の場合、 UUID()関数を使用して、列のデフォルト値としてユニバーサルユニーク識別子 (UUID)生成できます。
• バイナリ型の場合、 UUID_TO_BIN()関数を使用して UUID をバイナリ形式に変換し、変換された値を列のデフォルト値として設定できます。
• v8.0.0 以降、TiDB はBLOB 、 TEXT 、およびJSONデータ型に対してデフォルト値の指定追加でサポートしますが、それらに対してデフォルト値を設定するには式のみを使用できます。

列定義に明示的なDEFAULT値が含まれていない場合、TiDB は次のようにデフォルト値を決定します。

• 列が値としてNULL取ることができる場合、列は明示的なDEFAULT NULL句で定義されます。
• 列が値としてNULL取ることができない場合、TiDB は明示的なDEFAULT句なしで列を定義します。

明示的なDEFAULT句のないNOT NULL列へのデータ入力の場合、 INSERTまたはREPLACEステートメントに列の値が含まれていないと、TiDB はその時点で有効な SQL モードに従って列を処理します。

• 厳密な SQL モードが有効になっている場合、トランザクション テーブルではエラーが発生し、ステートメントはロールバックされます。非トランザクション テーブルではエラーが発生します。
• 厳密モードが有効になっていない場合、TiDB は列を列データ型の暗黙的なデフォルト値に設定します。

暗黙のデフォルトは次のように定義されます。

• 数値型の場合、デフォルトは 0 ですAUTO_INCREMENT属性で宣言された場合、デフォルトはシーケンス内の次の値になります。
• TIMESTAMP以外の日付と時刻の型の場合、デフォルトはその型に適切な「ゼロ」値です。 TIMESTAMP場合、デフォルト値は現在の日付と時刻です。
• ENUM以外の文字列型の場合、デフォルト値は空の文字列です。 ENUMの場合、デフォルト値は最初の列挙値です。

式をデフォルト値として指定する

MySQL 8.0.13 以降では、 DEFAULT句でデフォルト値として式を指定できるようになりました。詳細については、 MySQL 8.0.13 以降の明示的なデフォルト処理参照してください。

v8.0.0 以降、TiDB はDEFAULT句のデフォルト値として次の式を指定することもサポートします。

• UPPER(SUBSTRING_INDEX(USER(), '@', 1))
• REPLACE(UPPER(UUID()), '-', '')
• 次の形式のDATE_FORMAT式:
  • DATE_FORMAT(NOW(), '%Y-%m')
  • DATE_FORMAT(NOW(), '%Y-%m-%d')
  • DATE_FORMAT(NOW(), '%Y-%m-%d %H.%i.%s')
  • DATE_FORMAT(NOW(), '%Y-%m-%d %H:%i:%s')
• STR_TO_DATE('1980-01-01', '%Y-%m-%d')

v8.0.0 以降、TiDB はBLOB 、 TEXT 、 JSONデータ型にデフォルト値を割り当てることもサポートしています。ただし、これらのデータ型のデフォルト値を設定するには、式のみを使用できます。以下はBLOBの例です。

CREATE TABLE t2 (b BLOB DEFAULT (RAND()));