HINT的基本语法和使用场景介绍 - 云原生多模数据库 Lindorm

HINT作为一种SQL补充语法，在数据库中扮演着非常重要的角色。HINT可以改变SQL的执行方式。Lindorm宽表SQL也支持HINT语法，例如使用HINT进行多版本数据管理。本文介绍HINT的基本语法和使用场景。

前提条件

宽表引擎为2.3.1及以上版本。如何查看或升级当前版本，请参见宽表引擎版本说明和升级小版本。

使用限制

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操作的执行超时时间。默认值为120,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。取值如下： true：仅查询表中的热数据。 false：查询表中所有数据。说明 _l_hot_only_设置为`false`时，与不使用该HINT的查询效果相同。

示例

示例一：在执行统计表大小的查询中指定该DML操作的超时时间为30,000ms。

SELECT /*+  _l_operation_timeout_(30000) */ COUNT(*) FROM t_test_ts;

返回结果：

+----------+
| COUNT(*) |
+----------+
| 1        |
+----------+

示例二：在写入数据行时指定该DML操作的超时时间为30,000ms。

UPSERT /*+  _l_operation_timeout_(30000) */ INTO t_test_ts(c1, c2, c3) values(1,2,3);

示例三：在删除满足条件的数据时指定该DML操作执行的超时时间为30,000ms。
```
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。

通过HINT查询热数据