MySQL的系统变量max_execution_time小结

参数介绍：

MySQL社区版MySQL 5.7.8开始，新增了MAX_EXECUTION_TIME这个系统变量，它用来限制SQL语句的执行时间，确切来说是限制只读SELECT语句。如果查询语句的执行时长超过这个阈值，MySQL将自动停止该SQL语句的执行。如果其值为 0，表示不启用该超时限制功能。该参数/变量单位是毫秒(milliseconds),千万要注意，单位是毫秒。不是秒。

官方文档^[1]关于系统变量max_execution_time的描述如下：

The execution timeout for SELECT statements, in milliseconds. If the value is 0, timeouts are not enabled.

max_execution_time applies as follows:

The global max_execution_time value provides the default for the session value for new connections. The session value applies to SELECT executions executed within the session that include no MAX_EXECUTION_TIME(N) optimizer hint or for which N is 0.

max_execution_time applies to read-only SELECT statements. Statements that are not read only are those that invoke a stored function that modifies data as a side effect.

max_execution_time is ignored for SELECT statements in stored programs.or SELECT statements in stored programs.

注意事项：

1. max_execution_time只对只读的select有效，对DDL及UPDATE、DELETE等DML操作不生效
2. 只有顶层（即不是子查询）SQL受到影响
3. 存储程序中的 SELECT 语句，不受影响。即使存储过程中SELECT语句使用MAX_EXECUTION_TIME提示也不受影响

生产环境较常见的情况是，由于没有正确配置JDBC等驱动，导致业务代码已经超时退出了与数据库的交互，但是数据库里依旧运行着发起的SQL，如果频繁发起重试，则慢SQL会越来越多，导致数据库负载高，影响稳定性及可用性。因此，建议设置参数max_execution_time来解决这种情况。但是，由于生产环境的复杂性，需要跟开发人员先协商，另外，这个值可能需要设置的相对大一些，避免影响业务。总之来说是谨慎使用。

其实在MySQL 5.6的时候，其他分支版本（从所查资料来看，最开始是twitter的分支版本^[2]引入的，也被Percona Server 5.6分支版本并入）引入了系统变量max_statement_time来控制MySQL的最长执行时间。如果超过该系统变量的值，查询将会自动失败，默认是不限制。

不过MySQL社区版在MySQL 5.6并未引入这个系统变量，从社区版MySQL 5.7.4开始，才开始引入了系统变量max_statement_time。不过这个系统变量在MySQL 5.7.8被移除。具体可以参考官方文档^[3]。其实这个系统变量之所以在MySQL 5.7.8被移除，是因为用系统变量max_execution_time替换了系统变量max_statement_time

• max_statement_time: Statement execution timeout value. Added in MySQL 5.7.4.
• max_statement_time: Statement execution timeout value. Removed in MySQL 5.7.8.

参数设置

全局级别

方法1.在参数文件my.cnf中设置

max_execution_time=20000

注意：这种方法，需要重启MySQL数据库实例才能生效。

方法2：

mysql> set global max_execution_time=20000;
Query OK, 0 rows affected (0.00 sec)

注意，设置全局系统变量后，对当前会话不生效，正确来说已经建立连接的会话是不生效的，它只对全局系统变量设置后，新建立的会话生效。如下所示，另外，重启后会系统变量值会失效。

mysql> show variables like 'max_execution_time';
+--------------------+-------+
| Variable_name      | Value |
+--------------------+-------+
| max_execution_time | 0     |
+--------------------+-------+
1 row in set (0.00 sec)

mysql> 
mysql> select  @@global.max_execution_time, @@session.max_execution_time;

如果想重启后也能生效，可以使用下面SQL设置

mysql> set persist max_execution_time=20000;
Query OK, 0 rows affected (0.01 sec)

会话级别

mysql> set max_execution_time=1000;
Query OK, 0 rows affected (0.00 sec)

SQL语句级别

其实这里使用HINT来限制SELECT查询的最大时长，也的确是在语句级别执行限制。

SELECT /*+ MAX_EXECUTION_TIME(3000) */ * FROM table_name;

上述SQL语句表示，执行该查询，并设置执行时间为3秒，在超时时间到达时，MySQL将自动停止该查询的执行。注意：该选项只在使用InnoDB的默认存储引擎时有效，如果需要在其他存储引擎中使用该选项，请自行查阅文档或手册。

mysql>  SELECT /*+ MAX_EXECUTION_TIME(2000) */ * FROM TEST;
ERROR 3024 (HY000): Query execution was interrupted, maximum statement execution time exceeded
mysql> 

参考资料