Documentation Home
MySQL 8.3 Reference Manual
Related Documentation Download this Manual
PDF (US Ltr) - 40.8Mb
PDF (A4) - 40.9Mb
Man Pages (TGZ) - 294.0Kb
Man Pages (Zip) - 409.0Kb
Info (Gzip) - 4.0Mb
Info (Zip) - 4.0Mb
Excerpts from this Manual

MySQL 8.3 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 |
+-------------------------+

如果这样的操作结果用于更新 UNSIGNED 整数列,结果将被剪辑到该列类型的最大值,或者如果启用了 NO_UNSIGNED_SUBTRACTION,则剪辑到 0。如果启用了严格 SQL 模式,错误将发生,列将保持不变。