Documentation Home
MySQL 8.4 Reference Manual
Related Documentation Download this Manual
PDF (US Ltr) - 39.8Mb
PDF (A4) - 39.9Mb
Man Pages (TGZ) - 257.9Kb
Man Pages (Zip) - 364.9Kb
Info (Gzip) - 4.0Mb
Info (Zip) - 4.0Mb


MySQL 8.4 Reference Manual  /  ...  /  Out-of-Range and Overflow Handling

13.1.7 超出范围和溢出处理

当MySQL将一个值存储在一个超出了该列数据类型允许范围的数值列中时,结果取决于SQL模式在操作时的效果:

  • 如果启用严格SQL模式,MySQL会拒绝超出范围的值并返回错误,插入操作失败,这符合SQL标准。

  • 如果没有启用任何限制性模式,MySQL将值裁剪到列数据类型范围的适当端点,并存储结果值。

    当一个整数列被分配一个超出范围的值时,MySQL会存储表示该列数据类型范围端点的值。

    当一个浮点或定点数列被赋予一个超过指定(或默认)精度和比例的值时,MySQL会存储表示该范围端点的值。

假设表t1有以下定义:

CREATE TABLE t1 (i1 TINYINT, i2 TINYINT UNSIGNED);

在启用严格SQL模式的情况下,超出范围错误发生:

mysql> SET sql_mode = 'TRADITIONAL';
mysql> INSERT INTO t1 (i1, i2) VALUES(256, 256);
ERROR 1264 (22003): Out of range value for column 'i1' at row 1
mysql> SELECT * FROM t1;
Empty set (0.00 sec)

在未启用严格SQL模式的情况下,裁剪与警告发生:

mysql> SET sql_mode = '';
mysql> INSERT INTO t1 (i1, i2) VALUES(256, 256);
mysql> SHOW WARNINGS;
+---------+------+---------------------------------------------+
| Level   | Code | Message                                     |
+---------+------+---------------------------------------------+
| Warning | 1264 | Out of range value for column 'i1' at row 1 |
| Warning | 1264 | Out of range value for column 'i2' at row 1 |
+---------+------+---------------------------------------------+
mysql> SELECT * FROM t1;
+------+------+
| i1   | i2   |
+------+------+
|  127 |  255 |
+------+------+

当严格SQL模式不被启用时,表赋值转换由于裁剪而发生的,会以警告形式报告于ALTER TABLELOAD DATAUPDATE和多行INSERT语句中。严格模式下,这些语句失败,可能会导致一些或所有值未被插入或更改,取决于表是否是事务表以及其他因素。详细信息请参阅第7.1.11节,“服务器SQL模式”

在执行数值表达式时的溢出会导致错误。例如,最大有符号BIGINT值是9223372036854775807,因此以下表达式会产生错误:

mysql> SELECT 9223372036854775807 + 1;
ERROR 1690 (22003): BIGINT value is out of range in '(9223372036854775807 + 1)'

为了使操作成功进行,可以将值转换为无符号类型;

mysql> SELECT CAST(9223372036854775807 AS UNSIGNED) + 1;
+-------------------------------------------+
| CAST(9223372036854775807 AS UNSIGNED) + 1 |
+-------------------------------------------+
|                       9223372036854775808 |
+-------------------------------------------+

溢出是否发生取决于操作数的范围,所以另一种处理前述表达式的方式是使用精确值算术,因为DECIMAL值有更大的范围:

mysql> SELECT 9223372036854775807.0 + 1;
+---------------------------+
| 9223372036854775807.0 + 1 |
+---------------------------+
|     9223372036854775808.0 |
+---------------------------+

在进行整数值之间的减法操作时,如果一个是类型UNSIGNED,结果默认为无符号。若结果将会是负数,则会发生错误:

mysql> SET sql_mode = '';
Query OK, 0 rows affected (0.00 sec)

mysql> SELECT CAST(0 AS UNSIGNED) - 1;
ERROR 1690 (22003): BIGINT UNSIGNED value is out of range in '(cast(0 as unsigned) - 1)'

如果启用了NO_UNSIGNED_SUBTRACTION SQL模式,结果为负数:

mysql> SET sql_mode = 'NO_UNSIGNED_SUBTRACTION';
mysql> SELECT CAST(0 AS UNSIGNED) - 1;
+-------------------------+
| CAST(0 AS UNSIGNED) - 1 |
+-------------------------+
|                      -1 |
+-------------------------+

如果这样的操作的结果用于更新一个无符号整数列,那么结果会被裁剪到该列类型的最大值,或在NO_UNSIGNED_SUBTRACTION启用时裁剪到0。如果严格SQL模式被启用,则会发生错误,且列保持不变。