本文介绍了自定义SQL超时时间HINT的语法和示例。

本文适用于PolarDB-X 1.0 5.3及以上版本,其他版本请参见如何使用HINT(5.2及以下版本适用)

PolarDB-X 1.0中,PolarDB-X 1.0节点与RDS的默认的SQL执行超时时间是900秒(可以调整),但是对于某些特定的慢SQL,其执行时间可能超过了900秒 。针对这种慢SQL,PolarDB-X 1.0提供了调整超时时间的自定义HINT。通过这个自定义HINT可以任意调整SQL执行时长。

语法

/*+TDDL:SOCKET_TIMEOUT(time)*/        

其中,SOCKET_TIMEOUT的单位是毫秒。通过该HINT用户可以根据业务需要,自由调整SQL语句的超时时间。

注意事项

  • PolarDB-X 1.0自定义HINT支持/*+TDDL:hint_command*//!+TDDL:hint_command*/两种格式。
  • 如果使用/*+TDDL:hint_command*/格式,在使用MySQL官方命令行客户端执行带有PolarDB-X 1.0自定义HINT的SQL时,请在登录命令中加上-c 参数。否则,由于PolarDB-X 1.0自定义HINT是以MySQL 注释形式使用的,该客户端会将注释语句删除后再发送到服务端执行,导致PolarDB-X 1.0自定义HINT失效。具体请查看MySQL 官方客户端命令

示例

设置SQL超时时间为40秒:

/*+TDDL:SOCKET_TIMEOUT(40000)*/SELECT * FROM t_item;    
说明 超时时间设置得越长,占用数据库资源的时间就会越长。如果同一时间长时间执行的SQL过多,可能消耗大量的数据库资源,从而导致无法正常使用数据库服务。所以,对于长时间执行的SQL语句,尽量对SQL语句进行优化。