HINT作为一种SQL补充语法,在数据库中扮演着非常重要的角色。HINT可以改变SQL的执行方式。Lindorm宽表SQL也支持HINT语法,例如使用HINT进行多版本数据管理。本文介绍HINT的基本语法和使用场景。
前提条件
使用限制
- HINT必须在INSERT、UPSERT、DELETE和SELECT关键字后使用。
- 宽表引擎为2.5.2.1以下版本时,HINT仅支持简单查询,不支持子查询、分组查询等复杂查询。
HINT语法
hintExpression ::= /*+ hintItems */
hintItems ::= hintItem (',' hintItem )*
hintItem ::= identifier ('(' hintOption ( ',' hintOption)* ')')?
identifier ::= ( [A-Z] | '_' ) ( [A-Z] | [0-9] | '_' | '@' | ':')*
说明
- HINT的格式为
/*+ hintItems */
。其中hintItems
是HINT语句,与具体的操作相关。多个hintItems
之间需使用半角逗号(,)分隔。 - Lindorm宽表SQL语句中,仅允许直接在INSERT、UPSERT、DELETE和SELECT关键字后指定HINT。错误示例:
UPSERT INTO /*+ _l_ts_(3000) */ t_test_ts(c1, c3) VALUES (1, 'c3');
。
hintOption参数说明
参数 | 数据类型 | 说明 |
---|---|---|
_l_operation_timeout_ 说明 宽表引擎为2.5.2.1以下版本时,该参数名称为operationtimeout。 | INT | DML操作的执行超时时间。默认值为60,000。取值范围大于0,单位为毫秒(ms)。支持UPSERT、DELETE和SELECT。 说明 _l_operation_timeout_可以和其他HINT参数同时使用,使用时需要用英文逗号(,)分隔。例如: SELECT /*+ _l_operation_timeout_(1000), _l_force_index_('idx1') */ * from test; 。 |
_l_force_index_ | STRING | 强制选择索引。仅支持SELECT。 说明 _l_force_index_参数不能与_l_ignore_index_参数同时使用。 |
_l_ignore_index_ | 不涉及 | 忽略索引,不使用索引直接在数据表查询数据。可用于对比使用索引和不使用索引时的查询性能差异等场景。不涉及取值,使用时直接调用即可。仅支持SELECT。 说明 _l_ignore_index_参数不能与_l_force_index_参数同时使用。 |
_l_allow_filtering_ | 不涉及 | 默认情况下,若查询的WHERE条件为非主键列时,查询将报错。使用该参数后,允许进行低效全表扫描查询,查询将不会报错。不涉及取值,使用时直接调用即可。仅支持SELECT。 |
_l_versions_ | INT | 在查询结果中返回最新N个版本的数据。取值范围大于0。仅支持SELECT。 |
_l_ts_ | BIGINT | 多版本管理的时间戳,用于指定非主键列写入或查询时的时间戳。取值范围大于0。单位为毫秒(ms)。支持UPSERT和SELECT。 |
_l_ts_min_ | BIGINT | 多版本管理的最小时间戳,用于过滤查询结果。取值范围大于0。单位为毫秒(ms)。仅支持SELECT。 |
_l_ts_max_ | BIGINT | 多版本管理的最大时间戳,用于过滤查询结果。取值范围大于0。单位为毫秒(ms)。仅支持SELECT。 |
_l_hot_only_ | BOOLEAN | 是否只查询热数据。仅支持SELECT。 取值如下:
|
示例
- 示例一:统计DML操作执行的超时时间为30000ms的数据。
返回结果:SELECT /*+ _l_operation_timeout_(30000) */ COUNT(*) FROM t_test_ts;
+----------+ | COUNT(*) | +----------+ | 1 | +----------+
- 示例二:为写入的数据行指定DML操作执行的超时时间。
UPSERT /*+ _l_operation_timeout_(30000) */ INTO t_test_ts(c1, c2, c3) values(1,2,3);
- 示例三:删除指定条件下DML操作执行的超时时间为30000ms的数据。
DELETE /*+ _l_operation_timeout_(30000) */ FROM tb WHERE c1 = 1;
- 示例四:使用_l_force_index_强制选择索引。
SELECT /*+ _l_force_index_('idx1') */ COUNT(*) FROM tb; //'idx1' 为已经创建的索引名称。
返回结果:+----------+ | COUNT(*) | +----------+ | 1 | +----------+
- 示例五:使用_l_ignore_index_强制忽略索引。
返回结果:SELECT /*+ _l_ignore_index_ */ COUNT(*) FROM tb;
+----------+ | COUNT(*) | +----------+ | 1 | +----------+
- 示例六:使用_l_allow_filtering_过滤指定数据。
返回结果:SELECT /*+ _l_allow_filtering_ */ COUNT(*) FROM tb WHERE c1 = 2;
过滤条件中的+----------+ | COUNT(*) | +----------+ | 1 | +----------+
c1
不是主键,也不是索引。使用该HINT后不会报错。 - 示例七:使用_l_ts_为写入的数据行指定时间戳。
UPSERT /*+ _l_ts_(3000) */ INTO t_test_ts(c1, c3) VALUES (1, 'c3');
- 示例八:使用_l_versions_返回最新版本的数据。
SELECT /*+ _l_versions_(1) */ c1, c3, c3_l_ts FROM t_test_ts;
返回结果:+----+----+---------+ | c1 | c3 | c3_l_ts | +----+----+---------+ | 1 | c3 | 3000 | +----+----+---------+
使用场景
在以下场景中可以使用HINT。