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有以下定义:

Press CTRL+C to copy
CREATE TABLE t1 (i1 TINYINT, i2 TINYINT UNSIGNED);

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

Press CTRL+C to copy
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模式的情况下,裁剪与警告发生:

Press CTRL+C to copy
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,因此以下表达式会产生错误:

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

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

Press CTRL+C to copy
mysql> SELECT CAST(9223372036854775807 AS UNSIGNED) + 1; +-------------------------------------------+ | CAST(9223372036854775807 AS UNSIGNED) + 1 | +-------------------------------------------+ | 9223372036854775808 | +-------------------------------------------+

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

Press CTRL+C to copy
mysql> SELECT 9223372036854775807.0 + 1; +---------------------------+ | 9223372036854775807.0 + 1 | +---------------------------+ | 9223372036854775808.0 | +---------------------------+

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

Press CTRL+C to copy
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模式,结果为负数:

Press CTRL+C to copy
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模式被启用,则会发生错误,且列保持不变。