Documentation Home
MySQL 5.7 Reference Manual
Related Documentation Download this Manual
PDF (US Ltr) - 35.1Mb
PDF (A4) - 35.2Mb
Man Pages (TGZ) - 256.4Kb
Man Pages (Zip) - 361.2Kb
Info (Gzip) - 3.4Mb
Info (Zip) - 3.4Mb
Excerpts from this Manual

1.6.3.4 ENUM and SET Constraints

ENUM andSET columns provide an efficient way to define columns that can contain only a given set of values. SeeSection 11.3.5, “The ENUM Type”, andSection 11.3.6, “The SET Type”.

Unless strict mode is disabled (not recommended, but seeSection 5.1.10, “Server SQL Modes”), the definition of aENUM orSET column acts as a constraint on values entered into the column. An error occurs for values that do not satisfy these conditions:

  • AnENUM value must be one of those listed in the column definition, or the internal numeric equivalent thereof. The value cannot be the error value (that is, 0 or the empty string). For a column defined asENUM('a','b','c'), values such as'','d', or'ax' are invalid and are rejected.

  • ASET value must be the empty string or a value consisting only of the values listed in the column definition separated by commas. For a column defined asSET('a','b','c'), values such as'd' or'a,b,c,d' are invalid and are rejected.

Errors for invalid values can be suppressed in strict mode if you useINSERT IGNORE orUPDATE IGNORE. In this case, a warning is generated rather than an error. ForENUM, the value is inserted as the error member (0). ForSET, the value is inserted as given except that any invalid substrings are deleted. For example,'a,x,b,y' results in a value of'a,b'.