Rechercher dans le manuel MySQL

11.2.6 Out-of-Range and Overflow Handling

Table des matières

When MySQL stores a value in a numeric column that is outside the permissible range of the column data type, the result depends on the SQL mode in effect at the time:

  • If strict SQL mode is enabled, MySQL rejects the out-of-range value with an error, and the insert fails, in accordance with the SQL standard.

  • If no restrictive modes are enabled, MySQL clips the value to the appropriate endpoint of the column data type range and stores the resulting value instead.

    When an out-of-range value is assigned to an integer column, MySQL stores the value representing the corresponding endpoint of the column data type range.

    When a floating-point or fixed-point column is assigned a value that exceeds the range implied by the specified (or default) precision and scale, MySQL stores the value representing the corresponding endpoint of that range.

Suppose that a table t1 has this definition:

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

With strict SQL mode enabled, an out of range error occurs:

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

With strict SQL mode not enabled, clipping with warnings occurs:

  1. mysql> SET sql_mode = '';
  2. mysql> INSERT INTO t1 (i1, i2) VALUES(256, 256);
  3. mysql> SHOW WARNINGS;
  4. +---------+------+---------------------------------------------+
  5. | Level   | Code | Message                                     |
  6. +---------+------+---------------------------------------------+
  7. | Warning | 1264 | Out of range value for column 'i1' at row 1 |
  8. | Warning | 1264 | Out of range value for column 'i2' at row 1 |
  9. +---------+------+---------------------------------------------+
  10. mysql> SELECT * FROM t1;
  11. +------+------+
  12. | i1   | i2   |
  13. +------+------+
  14. |  127 |  255 |
  15. +------+------+

When strict SQL mode is not enabled, column-assignment conversions that occur due to clipping are reported as warnings for ALTER TABLE, LOAD DATA, UPDATE, and multiple-row INSERT statements. In strict mode, these statements fail, and some or all the values are not inserted or changed, depending on whether the table is a transactional table and other factors. For details, see Section 5.1.11, “Server SQL Modes”.

Overflow during numeric expression evaluation results in an error. For example, the largest signed BIGINT value is 9223372036854775807, so the following expression produces an error:

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

To enable the operation to succeed in this case, convert the value to unsigned;

  1. mysql> SELECT CAST(9223372036854775807 AS UNSIGNED) + 1;
  2. +-------------------------------------------+
  3. | CAST(9223372036854775807 AS UNSIGNED) + 1 |
  4. +-------------------------------------------+
  5. |                       9223372036854775808 |
  6. +-------------------------------------------+

Whether overflow occurs depends on the range of the operands, so another way to handle the preceding expression is to use exact-value arithmetic because DECIMAL values have a larger range than integers:

  1. mysql> SELECT 9223372036854775807.0 + 1;
  2. +---------------------------+
  3. | 9223372036854775807.0 + 1 |
  4. +---------------------------+
  5. |     9223372036854775808.0 |
  6. +---------------------------+

Subtraction between integer values, where one is of type UNSIGNED, produces an unsigned result by default. If the result would otherwise have been negative, an error results:

  1. mysql> SET sql_mode = '';
  2. Query OK, 0 rows affected (0.00 sec)
  3.  
  4. mysql> SELECT CAST(0 AS UNSIGNED) - 1;
  5. ERROR 1690 (22003): BIGINT UNSIGNED value is out of range in '(cast(0 as unsigned) - 1)'

If the NO_UNSIGNED_SUBTRACTION SQL mode is enabled, the result is negative:

  1. mysql> SET sql_mode = 'NO_UNSIGNED_SUBTRACTION';
  2. mysql> SELECT CAST(0 AS UNSIGNED) - 1;
  3. +-------------------------+
  4. | CAST(0 AS UNSIGNED) - 1 |
  5. +-------------------------+
  6. |                      -1 |
  7. +-------------------------+

If the result of such an operation is used to update an UNSIGNED integer column, the result is clipped to the maximum value for the column type, or clipped to 0 if NO_UNSIGNED_SUBTRACTION is enabled. If strict SQL mode is enabled, an error occurs and the column remains unchanged.


Rechercher dans le manuel MySQL

Traduction non disponible

Le manuel MySQL n'est pas encore traduit en français sur l'infobrol. Seule la version anglaise est disponible pour l'instant.

Document créé le 26/06/2006, dernière modification le 26/10/2018
Source du document imprimé : https://www.gaudry.be/mysql-rf-out-of-range-and-overflow.html

L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.

Références

  1. Consulter le document html Langue du document :en Manuel MySQL : https://dev.mysql.com/

Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.

Table des matières Haut