sql_mode
MySQL 服务器可以在不同的 SQL 模式下运行,并且可以根据系统变量
的值对不同的客户端应用这些模式。DBA 可以设置全局 SQL 模式以匹配站点服务器操作要求,每个应用程序可以根据自己的要求设置其会话 SQL 模式。
模式会影响 MySQL 支持的 SQL 语法及其执行的数据验证检查。这使得在不同环境中使用 MySQL 以及与其他数据库服务器一起使用 MySQL 变得更加容易。
有关 MySQL 中服务器 SQL 模式的常见问题解答,请参阅第 A.3 节,“MySQL 5.6 FAQ:服务器 SQL 模式”。
使用InnoDB
表时,还要考虑innodb_strict_mode
系统变量。InnoDB
它为表
启用额外的错误检查
。
默认的 SQL 模式是
NO_ENGINE_SUBSTITUTION
.
要在服务器启动时设置 SQL 模式,请
在命令行或
选项文件(例如(Unix 操作系统)或(Windows))中使用该选项。
是以逗号分隔的不同模式的列表。要明确清除 SQL 模式,请
在命令行或选项文件中将其设置为空字符串。
--sql-mode="
modes
"sql-mode="
modes
"my.cnf
my.ini
modes
--sql-mode=""
sql-mode=""
MySQL 安装程序可能会在安装过程中配置 SQL 模式。例如,
mysql_install_db创建一个my.cnf
在基本安装目录中命名的默认选项文件。该文件包含设置 SQL 模式的行;参见第 4.4.3 节,“mysql_install_db — 初始化 MySQL 数据目录”。
如果 SQL 模式不同于默认模式或您期望的模式,请检查服务器在启动时读取的选项文件中的设置。
要在运行时更改 SQL 模式,请
sql_mode
使用SET
语句设置全局或会话系统变量:
SET GLOBAL sql_mode = 'modes';
SET SESSION sql_mode = 'modes';
设置GLOBAL
变量需要
SUPER
特权并影响从那时起连接的所有客户端的操作。设置SESSION
变量仅影响当前客户端。每个客户端都可以随时更改其会话
sql_mode
值。
要确定当前的全局或会话
sql_mode
设置,请选择其值:
SELECT @@GLOBAL.sql_mode;
SELECT @@SESSION.sql_mode;
SQL 模式和用户定义的分区。 在创建分区表并将数据插入分区表后更改服务器 SQL 模式可能会导致此类表的行为发生重大变化,并可能导致数据丢失或损坏。强烈建议您在使用用户定义的分区创建表后永远不要更改 SQL 模式。
复制分区表时,源和副本上的不同 SQL 模式也会导致问题。为获得最佳结果,您应该始终在源和副本上使用相同的服务器 SQL 模式。
有关详细信息,请参阅 第 19.6 节,“分区的限制和限制”。
最重要的sql_mode
价值观可能是这些:
此模式更改语法和行为以更符合标准 SQL。它是 本节末尾列出 的特殊组合模式之一。
如果无法将给定的值插入到事务表中,则中止该语句。对于非事务表,如果值出现在单行语句或多行语句的第一行中,则中止语句。本节稍后将提供更多详细信息。
使 MySQL 表现得像一个“传统的” SQL 数据库系统。这种模式的简单描述是 在向列中插入不正确的值时“给出错误而不是警告” 。它是本节末尾列出 的特殊组合模式之一。
笔记TRADITIONAL
启用模式后,一旦发生错误 ,INSERT
or 就会中止。UPDATE
如果您正在使用非事务性存储引擎,这可能不是您想要的,因为在错误之前所做的数据更改可能无法回滚,从而导致“部分完成”更新。
当本手册提到“严格模式”时,它表示一种模式,其中一个或两个
STRICT_TRANS_TABLES
或
STRICT_ALL_TABLES
启用。
以下列表描述了所有支持的 SQL 模式:
不要执行完整的日期检查。只检查月份在 1 到 12 的范围内,日期在 1 到 31 的范围内。这可能对 Web 应用程序有用,这些应用程序在三个不同的字段中获取年月日并准确存储用户的内容已插入,没有日期验证。此模式适用于
DATE
和DATETIME
列。它不适用于TIMESTAMP
始终需要有效日期的列。ALLOW_INVALID_DATES
如果禁用,服务器要求月份和日期值是合法的,而不仅仅是分别在 1 到 12 和 1 到 31 的范围内 。'2004-04-31'
禁用严格模式后,将转换为 无效日期'0000-00-00'
并生成警告。启用严格模式后,无效日期会产生错误。要允许此类日期,请启用ALLOW_INVALID_DATES
.将其视为
"
标识符引号字符(如`
引号字符)而不是字符串引号字符。启用此模式后,您仍然可以使用`
引用标识符。启用后,您不能使用ANSI_QUOTES
双引号来引用文字字符串,因为它们被解释为标识符。该
ERROR_FOR_DIVISION_BY_ZERO
模式影响除以零的处理,其中包括 . 对于数据更改操作(, ),其效果还取决于是否启用了严格的 SQL 模式。MOD(
N
,0)INSERT
UPDATE
如果未启用此模式,则除以零会插入
NULL
并且不会产生警告。如果启用此模式,则除以零会插入
NULL
并产生警告。如果启用此模式和严格模式,除以零会产生错误,除非
IGNORE
也给出。对于INSERT IGNORE
和UPDATE IGNORE
,除以零插入NULL
并产生警告。
对于
SELECT
,除以零返回NULL
。启用ERROR_FOR_DIVISION_BY_ZERO
也会导致产生警告,无论是否启用严格模式。从 MySQL 5.6.17 开始,
ERROR_FOR_DIVISION_BY_ZERO
已弃用并设置sql_mode
包含它的值会生成警告。运算符的优先级
NOT
是这样的表达式,如NOT a BETWEEN b AND c
被解析为NOT (a BETWEEN b AND c)
。在一些旧版本的 MySQL 中,表达式被解析为(NOT a) BETWEEN b AND c
. 可以通过启用HIGH_NOT_PRECEDENCE
SQL 模式获得旧的更高优先级的行为。mysql> SET sql_mode = ''; mysql> SELECT NOT 1 BETWEEN -5 AND 5; -> 0 mysql> SET sql_mode = 'HIGH_NOT_PRECEDENCE'; mysql> SELECT NOT 1 BETWEEN -5 AND 5; -> 1
(
函数名称和字符 之间允许有空格 。这会导致内置函数名称被视为保留字。因此,与函数名称相同的标识符必须按照第 9.2 节“模式对象名称”中的描述进行引用。例如,因为有一个COUNT()
函数,count
在下面的语句中使用作为表名会导致错误:mysql> CREATE TABLE count (i INT); ERROR 1064 (42000): You have an error in your SQL syntax
表名应该被引用:
mysql> CREATE TABLE `count` (i INT); Query OK, 0 rows affected (0.00 sec)
SQL 模式适用于
IGNORE_SPACE
内置函数,不适用于可加载函数或存储函数。IGNORE_SPACE
无论是否启用 ,始终允许在可加载函数或存储函数名称后有空格 。有关 的进一步讨论
IGNORE_SPACE
,请参阅 第 9.2.5 节,“函数名称解析和解析”。除非指定了身份验证信息,否则阻止
GRANT
语句自动创建新用户(否则会自动创建新用户)。该语句必须指定一个非空密码 usingIDENTIFIED BY
或一个身份验证插件 usingIDENTIFIED WITH
。NO_AUTO_VALUE_ON_ZERO
影响AUTO_INCREMENT
列的处理。NULL
通常,您通过插入或 来为该列生成下一个序列号0
。NO_AUTO_VALUE_ON_ZERO
抑制此行为,0
以便仅NULL
生成下一个序列号。0
如果已存储在表的AUTO_INCREMENT
列中, 则此模式会很有用。(0
顺便说一句,不推荐存储。)例如,如果您使用mysqldump转储表然后重新加载它,MySQL 通常会在遇到0
值时生成新的序列号,从而导致表的内容与原来的不同那被丢弃了。NO_AUTO_VALUE_ON_ZERO
在重新加载转储文件之前启用 可解决此问题。为此,mysqldump自动在其输出中包含一条启用NO_AUTO_VALUE_ON_ZERO
.启用此模式将禁止使用反斜杠字符 (
\
) 作为字符串和标识符中的转义字符。启用此模式后,反斜杠像其他任何字符一样变成普通字符,并且LIKE
表达式的默认转义序列已更改,因此不使用转义字符。创建表时,忽略所有
INDEX DIRECTORY
和DATA DIRECTORY
指令。此选项在副本服务器上很有用。当诸如
CREATE TABLE
or之类的语句ALTER TABLE
指定禁用或未编译的存储引擎时,控制默认存储引擎的自动替换。因为存储引擎可以在运行时插入,所以不可用的引擎以相同的方式处理:
NO_ENGINE_SUBSTITUTION
如果禁用,则 使用CREATE TABLE
默认引擎,如果所需引擎不可用,则会出现警告。对于ALTER TABLE
,出现警告并且表未更改。启用后,如果所需的引擎不可用
NO_ENGINE_SUBSTITUTION
,则会发生错误并且不会创建或更改表。不要在 的输出中打印特定于 MySQL 的列选项
SHOW CREATE TABLE
。mysqldump在可移植模式下 使用此模式。不要在 的输出中打印特定于 MySQL 的索引选项
SHOW CREATE TABLE
。mysqldump在可移植模式下 使用此模式。不要
ENGINE
在 的输出中打印特定于 MySQL 的表选项(例如 )SHOW CREATE TABLE
。mysqldump在可移植模式下 使用此模式。默认情况下,整数值之间的减法,其中一个是类型
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 模式的情况下,发生错误并且该列保持不变。启用时
NO_UNSIGNED_SUBTRACTION
,减法结果是有符号的,即使任何操作数是无符号的。例如,将 table 中列的类型与c2
tablet1
中 列c2
的类型进行比较t2
:mysql> SET sql_mode=''; mysql> CREATE TABLE test (c1 BIGINT UNSIGNED NOT NULL); mysql> CREATE TABLE t1 SELECT c1 - 1 AS c2 FROM test; mysql> DESCRIBE t1; +-------+---------------------+------+-----+---------+-------+ | Field | Type | Null | Key | Default | Extra | +-------+---------------------+------+-----+---------+-------+ | c2 | bigint(21) unsigned | NO | | 0 | | +-------+---------------------+------+-----+---------+-------+ mysql> SET sql_mode='NO_UNSIGNED_SUBTRACTION'; mysql> CREATE TABLE t2 SELECT c1 - 1 AS c2 FROM test; mysql> DESCRIBE t2; +-------+------------+------+-----+---------+-------+ | Field | Type | Null | Key | Default | Extra | +-------+------------+------+-----+---------+-------+ | c2 | bigint(21) | NO | | 0 | | +-------+------------+------+-----+---------+-------+
这意味着它
BIGINT UNSIGNED
并非在所有情况下都 100% 可用。请参阅 第 12.11 节,“Cast 函数和运算符”。NO_ZERO_DATE
模式影响服务器是否允许 作为'0000-00-00'
有效日期。其效果还取决于是否启用了严格 SQL 模式。如果未启用此模式,
'0000-00-00'
则允许插入并且不会产生警告。如果启用此模式,
'0000-00-00'
则允许插入并产生警告。如果启用此模式和严格模式,
'0000-00-00'
则不允许插入并产生错误,除非IGNORE
也给出。对于INSERT IGNORE
andUPDATE IGNORE
,'0000-00-00'
是允许的,插入会产生警告。
从 MySQL 5.6.17 开始,
NO_ZERO_DATE
已弃用并设置sql_mode
包含它的值会生成警告。模式会影响服务器是否允许年份部分不为零但月份或日期部分为 0的日期。
NO_ZERO_IN_DATE
(此模式会影响诸如'2010-00-01'
或 之类的日期'2010-01-00'
,但不会 影响'0000-00-00'
。要控制服务器是否允许'0000-00-00'
,请使用该NO_ZERO_DATE
模式。)效果ofNO_ZERO_IN_DATE
还取决于是否启用了严格的 SQL 模式。如果未启用此模式,则允许包含零部分的日期并且插入不会产生警告。
如果启用此模式,则零部分的日期将被插入
'0000-00-00'
并产生警告。如果启用此模式和严格模式,则不允许包含零部分的日期并且插入会产生错误,除非
IGNORE
也给出。对于INSERT IGNORE
和UPDATE IGNORE
,零部分的日期被插入为'0000-00-00'
并产生警告。
从 MySQL 5.6.17 开始,
NO_ZERO_IN_DATE
已弃用并设置sql_mode
包含它的值会生成警告。拒绝选择列表、
HAVING
条件或ORDER BY
列表引用未在GROUP BY
子句中命名的非聚合列的查询。MySQL 对标准 SQL 的扩展允许在
HAVING
子句中引用选择列表中的别名表达式。启用ONLY_FULL_GROUP_BY
会禁用此扩展,因此需要HAVING
使用无别名表达式编写子句。有关其他讨论和示例,请参阅 第 12.19.3 节,“GROUP BY 的 MySQL 处理”。
默认情况下,尾随空格会
CHAR
在检索时从列值中删除。如果PAD_CHAR_TO_FULL_LENGTH
启用,则不会进行修剪,并且检索CHAR
到的值将填充到它们的全长。此模式不适VARCHAR
用于在检索时保留尾随空格的列。mysql> CREATE TABLE t1 (c1 CHAR(10)); Query OK, 0 rows affected (0.37 sec) mysql> INSERT INTO t1 (c1) VALUES('xy'); Query OK, 1 row affected (0.01 sec) mysql> SET sql_mode = ''; Query OK, 0 rows affected (0.00 sec) mysql> SELECT c1, CHAR_LENGTH(c1) FROM t1; +------+-----------------+ | c1 | CHAR_LENGTH(c1) | +------+-----------------+ | xy | 2 | +------+-----------------+ 1 row in set (0.00 sec) mysql> SET sql_mode = 'PAD_CHAR_TO_FULL_LENGTH'; Query OK, 0 rows affected (0.00 sec) mysql> SELECT c1, CHAR_LENGTH(c1) FROM t1; +------------+-----------------+ | c1 | CHAR_LENGTH(c1) | +------------+-----------------+ | xy | 10 | +------------+-----------------+ 1 row in set (0.00 sec)
为所有存储引擎启用严格的 SQL 模式。拒绝无效的数据值。有关详细信息,请参阅 严格 SQL 模式。
为事务存储引擎启用严格的 SQL 模式,并在可能的情况下为非事务存储引擎启用严格的 SQL 模式。有关详细信息,请参阅严格 SQL 模式。
以下特殊模式作为前面列表中模式值组合的简写形式提供。
相当于
REAL_AS_FLOAT
,PIPES_AS_CONCAT
,ANSI_QUOTES
,IGNORE_SPACE
。ANSI
mode 还会导致服务器为查询返回错误,其中 无法在已解析外部引用的外部查询中聚合S
具有外部引用 的集合函数。这是这样一个查询:S
(outer_ref
)SELECT * FROM t1 WHERE t1.a IN (SELECT MAX(t1.b) FROM t2 WHERE ...);
在这里,
MAX(t1.b)
不能在外部查询中聚合,因为它出现在该WHERE
查询的子句中。在这种情况下,标准 SQL 需要一个错误。如果ANSI
未启用模式,服务器 将以与解释相同的方式处理此类查询 。S
(outer_ref
)S
(const
)等同于
PIPES_AS_CONCAT
,ANSI_QUOTES
,IGNORE_SPACE
,NO_KEY_OPTIONS
,NO_TABLE_OPTIONS
,NO_FIELD_OPTIONS
。等同于
PIPES_AS_CONCAT
,ANSI_QUOTES
,IGNORE_SPACE
,NO_KEY_OPTIONS
,NO_TABLE_OPTIONS
,NO_FIELD_OPTIONS
,NO_AUTO_CREATE_USER
。等同于
PIPES_AS_CONCAT
,ANSI_QUOTES
,IGNORE_SPACE
,NO_KEY_OPTIONS
,NO_TABLE_OPTIONS
,NO_FIELD_OPTIONS
。相当于
MYSQL323
,HIGH_NOT_PRECEDENCE
。这意味着HIGH_NOT_PRECEDENCE
加上一些SHOW CREATE TABLE
特定于的行为MYSQL323
:相当于
MYSQL40
,HIGH_NOT_PRECEDENCE
。这意味着HIGH_NOT_PRECEDENCE
加上一些特定于MYSQL40
. 这些与 for 相同MYSQL323
,只是它SHOW CREATE TABLE
不显示HEAP
为MEMORY
表的存储引擎。等同于
PIPES_AS_CONCAT
,ANSI_QUOTES
,IGNORE_SPACE
,NO_KEY_OPTIONS
,NO_TABLE_OPTIONS
,NO_FIELD_OPTIONS
,NO_AUTO_CREATE_USER
。等同于
PIPES_AS_CONCAT
,ANSI_QUOTES
,IGNORE_SPACE
,NO_KEY_OPTIONS
,NO_TABLE_OPTIONS
,NO_FIELD_OPTIONS
。等同于
STRICT_TRANS_TABLES
,STRICT_ALL_TABLES
,NO_ZERO_IN_DATE
,NO_ZERO_DATE
,ERROR_FOR_DIVISION_BY_ZERO
,NO_AUTO_CREATE_USER
和NO_ENGINE_SUBSTITUTION
。
严格模式控制 MySQL 如何处理数据更改语句中的无效或缺失值,例如
INSERT
or
UPDATE
。一个值可能由于多种原因而无效。例如,列的数据类型可能有误,或者可能超出范围。当要插入的新行不包含在其定义NULL
中没有显式
DEFAULT
子句的非列的值时,将缺少一个值。(对于
NULL
列,NULL
如果值缺失则插入。)严格模式还会影响 DDL 语句,例如CREATE TABLE
.
如果严格模式未生效,则 MySQL 会为无效或缺失值插入调整后的值并产生警告(请参阅
第 13.7.5.41 节,“SHOW WARNINGS 语句”)。在严格模式下,您可以使用
INSERT IGNORE
or产生这种行为UPDATE
IGNORE
。
对于诸如SELECT
不更改数据之类的语句,无效值会在严格模式下生成警告,而不是错误。
从 MySQL 5.6.11 开始,严格模式会在尝试创建超过最大密钥长度的密钥时产生错误。以前,这会导致警告并将密钥截断为最大密钥长度(与未启用严格模式时相同)。
严格模式不影响是否检查外键约束。foreign_key_checks
可以用于那个。(请参阅
第 5.1.7 节,“服务器系统变量”。)
STRICT_ALL_TABLES
如果启用或
,
严格 SQL 模式将生效
STRICT_TRANS_TABLES
,尽管这些模式的效果有所不同:
对于事务表,当启用
STRICT_ALL_TABLES
或 时,数据更改语句中的无效值或缺失值会发生错误 。STRICT_TRANS_TABLES
该语句被中止并回滚。对于非事务表,如果错误值出现在要插入或更新的第一行中,两种模式的行为都是相同的:语句被中止,表保持不变。如果语句插入或修改多行并且错误值出现在第二行或后面的行中,则结果取决于启用的严格模式:
对于
STRICT_ALL_TABLES
,MySQL 返回错误并忽略其余行。但是,因为前面的行已被插入或更新,所以结果是部分更新。为避免这种情况,请使用单行语句,它可以在不更改表的情况下中止。对于
STRICT_TRANS_TABLES
,MySQL 将无效值转换为最接近列的有效值并插入调整后的值。如果缺少值,MySQL 将插入列数据类型的隐式默认值。在任何一种情况下,MySQL 都会生成警告而不是错误并继续处理该语句。隐式默认值在第 11.5 节,“数据类型默认值”中描述。
严格模式还会影响除以零、零日期和日期中的零的处理,以及
ERROR_FOR_DIVISION_BY_ZERO
、
NO_ZERO_DATE
和
NO_ZERO_IN_DATE
模式。有关详细信息,请参阅这些模式的描述。