MySQL :: MySQL 9.0 参考手册 :: 13.6 数据类型默认值

版本 9.0

8.4 当前
8.0
5.7

8.0 日语

13.6 数据类型默认值

数据类型规范可以具有显式或隐式默认值。

数据类型规范中的 DEFAULT value 子句显式指示列的默认值。示例

CREATE TABLE t1 (
  i     INT DEFAULT -1,
  c     VARCHAR(10) DEFAULT '',
  price DOUBLE(16,2) DEFAULT 0.00
);

SERIAL DEFAULT VALUE 是一个特殊情况。在整数列的定义中，它是 NOT NULL AUTO_INCREMENT UNIQUE 的别名。

显式 DEFAULT 子句处理的某些方面是版本相关的，如下所述。

显式默认处理

DEFAULT 子句中指定的默认值可以是文字常量或表达式。除一个例外情况外，将表达式默认值括在括号中以将其与文字常量默认值区分开来。示例

CREATE TABLE t1 (
  -- literal defaults
  i INT         DEFAULT 0,
  c VARCHAR(10) DEFAULT '',
  -- expression defaults
  f FLOAT       DEFAULT (RAND() * RAND()),
  b BINARY(16)  DEFAULT (UUID_TO_BIN(UUID())),
  d DATE        DEFAULT (CURRENT_DATE + INTERVAL 1 YEAR),
  p POINT       DEFAULT (Point(0,0)),
  j JSON        DEFAULT (JSON_ARRAY())
);

例外情况是，对于 TIMESTAMP 和 DATETIME 列，可以将 CURRENT_TIMESTAMP 函数指定为默认值，无需括号。请参见第 13.2.5 节，“TIMESTAMP 和 DATETIME 的自动初始化和更新”。

BLOB、TEXT、GEOMETRY 和 JSON 数据类型只能在将值编写为表达式时才能分配默认值，即使表达式值为文字。

这是允许的（文字默认值指定为表达式）
```
CREATE TABLE t2 (b BLOB DEFAULT ('abc'));
```
这将产生错误（文字默认值未指定为表达式）
```
CREATE TABLE t2 (b BLOB DEFAULT 'abc');
```

表达式默认值必须遵守以下规则。如果表达式包含不允许的构造，则会发生错误。

允许使用文字、内置函数（确定性和非确定性函数）和运算符。
不允许使用子查询、参数、变量、存储函数和可加载函数。
表达式默认值不能依赖于具有 AUTO_INCREMENT 属性的列。
一列的表达式默认值可以引用其他表列，但例外情况是，对生成列或具有表达式默认值的列的引用必须是对表定义中更早出现的列的引用。也就是说，表达式默认值不能包含对生成列或具有表达式默认值的列的正向引用。
排序约束也适用于使用 ALTER TABLE 重新排序表列。如果结果表将具有包含对生成列或具有表达式默认值的列的正向引用的表达式默认值，则该语句将失败。

注意

如果表达式默认值的任何组成部分依赖于 SQL 模式，则除非在所有使用过程中 SQL 模式相同，否则不同使用表时可能会产生不同的结果。

对于 CREATE TABLE ... LIKE 和 CREATE TABLE ... SELECT，目标表会保留原始表中的表达式默认值。

如果表达式默认值引用了非确定性函数，则导致该表达式求值的任何语句对于基于语句的复制都是不安全的。这包括 INSERT 和 UPDATE 等语句。在这种情况下，如果二进制日志记录已禁用，则该语句将照常执行。如果二进制日志记录已启用并且 binlog_format 设置为 STATEMENT，则该语句将被记录并执行，但一条警告消息将写入错误日志，因为副本可能存在差异。当 binlog_format 设置为 MIXED 或 ROW 时，该语句将照常执行。

插入新行时，可以省略列名或将列指定为 DEFAULT（与具有文字默认值的列一样）来插入具有表达式默认值的列的默认值。

mysql> CREATE TABLE t4 (uid BINARY(16) DEFAULT (UUID_TO_BIN(UUID())));
mysql> INSERT INTO t4 () VALUES();
mysql> INSERT INTO t4 () VALUES(DEFAULT);
mysql> SELECT BIN_TO_UUID(uid) AS uid FROM t4;
+--------------------------------------+
| uid                                  |
+--------------------------------------+
| f1109174-94c9-11e8-971d-3bf1095aa633 |
| f110cf9a-94c9-11e8-971d-3bf1095aa633 |
+--------------------------------------+

但是，仅当列具有文字默认值时才允许使用 DEFAULT(col_name) 指定命名列的默认值，而不允许对具有表达式默认值的列使用。

并非所有存储引擎都允许表达式默认值。对于不支持的存储引擎，将发生 ER_UNSUPPORTED_ACTION_ON_DEFAULT_VAL_GENERATED 错误。

如果默认值计算出的数据类型与声明的列类型不同，则根据通常的 MySQL 类型转换规则，会发生对声明类型的隐式强制转换。请参见第 14.3 节，“表达式求值中的类型转换”。

隐式默认处理

如果数据类型规范不包含显式 DEFAULT 值，则 MySQL 会按如下方式确定默认值。

如果该列可以接受 NULL 作为值，则该列将使用显式 DEFAULT NULL 子句进行定义。

如果该列不能接受 NULL 作为值，则 MySQL 将使用不包含显式 DEFAULT 子句的列进行定义。

对于插入不包含显式 DEFAULT 子句的 NOT NULL 列的数据，如果 INSERT 或 REPLACE 语句不包含该列的值，或者 UPDATE 语句将该列设置为 NULL，则 MySQL 将根据当时有效的 SQL 模式处理该列。

如果启用了严格 SQL 模式，则对事务表将发生错误，并且该语句将回滚。对于非事务表，将发生错误，但如果对多行语句的第二行或后续行发生这种情况，则前面的行将被插入。
如果未启用严格模式，则 MySQL 会将该列设置为该列数据类型的隐式默认值。

假设表 t 定义如下。

CREATE TABLE t (i INT NOT NULL);

在这种情况下，i 没有显式默认值，因此在严格模式下，以下每个语句都会产生错误，并且不会插入任何行。当不使用严格模式时，只有第三个语句会产生错误；前两个语句会插入隐式默认值，但第三个会失败，因为 DEFAULT(i) 无法生成值。

INSERT INTO t VALUES();
INSERT INTO t VALUES(DEFAULT);
INSERT INTO t VALUES(DEFAULT(i));

请参见第 7.1.11 节，“服务器 SQL 模式”。

对于给定表，SHOW CREATE TABLE 语句将显示哪些列具有显式 DEFAULT 子句。

隐式默认值定义如下：

对于数值类型，默认值为 0，但如果整型或浮点型声明了 AUTO_INCREMENT 属性，则默认值为序列中的下一个值。
对于除 TIMESTAMP 之外的日期和时间类型，默认值为该类型的相应 “零” 值。这对于 TIMESTAMP 也是如此，只要 explicit_defaults_for_timestamp 系统变量被启用（参见第 7.1.8 节，“服务器系统变量”）。否则，对于表中的第一个 TIMESTAMP 列，默认值为当前日期和时间。参见第 13.2 节，“日期和时间数据类型”。
对于除 ENUM 之外的字符串类型，默认值为空字符串。对于 ENUM，默认值为第一个枚举值。