data-type-default-values.md

title	aliases	summary
数据类型的默认值	/docs-cn/dev/data-type-default-values/ /docs-cn/dev/reference/sql/data-types/default-values/	数据类型的默认值描述了列的默认值设置规则。默认值必须是常量，对于时间类型可以使用特定函数。从 v8.0.0 开始，BLOB、TEXT 和 JSON 可以设置表达式默认值。如果列没有设置 DEFAULT，TiDB 会根据规则添加隐式默认值。对于 NOT NULL 列，根据 SQL_MODE 进行不同行为。表达式默认值是实验特性，不建议在生产环境中使用。MySQL 8.0.13 开始支持在 DEFAULT 子句中指定表达式为默认值。TiDB 支持为 BLOB、TEXT 和 JSON 数据类型分配默认值，但仅支持通过表达式来设置。

数据类型的默认值

在一个数据类型描述中的 DEFAULT value 段描述了一个列的默认值。

所有数据类型都可以设置默认值。这个默认值通常情况下必须是常量，不可以是一个函数或者是表达式，但也存在以下例外情况：

• 对于时间类型，可以使用 NOW、CURRENT_TIMESTAMP、LOCALTIME、LOCALTIMESTAMP 等函数作为 DATETIME 或者 TIMESTAMP 列的默认值。
• 对于整数类型，可以使用 NEXT VALUE FOR 函数将序列的下一个值作为列的默认值，使用 RAND() 函数生成随机浮点值作为列的默认值。
• 对于字符串类型，可以使用 UUID() 函数生成通用唯一标识符 (UUID) 作为列的默认值。
• 对于二进制类型，可以使用 UUID_TO_BIN() 函数将 UUID 转换为二进制格式后作为列的默认值。
• 从 v8.0.0 开始，新增支持 BLOB、TEXT 以及 JSON 这三种数据类型设置默认值，但仅支持使用表达式设置默认值。

如果一个列的定义中没有 DEFAULT 的设置。TiDB 按照如下的规则决定：

• 如果该类型可以使用 NULL 作为值，那么这个列会在定义时添加隐式的默认值设置 DEFAULT NULL。
• 如果该类型无法使用 NULL 作为值，那么这个列在定义时不会添加隐式的默认值设置。

对于一个设置了 NOT NULL 但是没有显式设置 DEFAULT 的列，当 INSERT、REPLACE 没有涉及到该列的值时，TiDB 根据当时的 SQL_MODE 进行不同的行为：

• 如果此时是 strict sql mode，在事务中的语句会导致事务失败并回滚，非事务中的语句会直接报错。
• 如果此时不是 strict sql mode，TiDB 会为这列赋值为列数据类型的隐式默认值。

此时隐式默认值的设置按照如下规则：

• 对于数值类型，它们的默认值是 0。当有 AUTO_INCREMENT 参数时，默认值会按照增量情况赋予正确的值。
• 对于除了时间戳外的日期时间类型，默认值会是该类型的“零值”。时间戳类型的默认值会是当前的时间。
• 对于除枚举以外的字符串类型，默认值会是空字符串。对于枚举类型，默认值是枚举中的第一个值。

表达式默认值

MySQL 从 8.0.13 开始支持在 DEFAULT 子句中指定表达式为默认值。具体可参考 Explicit Default Handling as of MySQL 8.0.13。

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')
• CURRENT_TIMESTAMP() 和 CURRENT_DATE()：均使用默认的时间精度(fractional seconds precision, fsp)
• JSON_OBJECT()，JSON_ARRAY()，JSON_QUOTE()
• NEXTVAL()
• RAND()
• UUID()，UUID_TO_BIN()
• VEC_FROM_TEXT()

TiDB 支持为 BLOB、TEXT 以及 JSON 数据类型分配默认值，但是，你只能使用表达式来设置这些数据类型的默认值，而不能使用字面量。

以下是 BLOB 的示例：

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

以下是使用 UUID 的示例：

CREATE TABLE t3 (
  uuid BINARY(16) DEFAULT (UUID_TO_BIN(UUID())),
  name VARCHAR(255)
);

更多关于如何使用 UUID 的内容，请参考 UUID 最佳实践。

以下是使用 JSON 的示例：

CREATE TABLE t4 (
  id bigint AUTO_RANDOM PRIMARY KEY,
  j json DEFAULT (JSON_OBJECT("a", 1, "b", 2))
);

以下是使用 JSON 时不被允许的示例：

CREATE TABLE t5 (
  id bigint AUTO_RANDOM PRIMARY KEY,
  j json DEFAULT ('{"a": 1, "b": 2}')
);

最后两个示例都描述了相似的默认值，但只有第一个是允许的，因为它使用的是表达式而不是字面量。