[TOC] # 在查询中使用 SQL Hint 初次使用 OceanBase 的用户，经常会用大表测试各种查询，有时会感觉性能不是很快，此时需要在查询中使用 SQL Hint。 ## 关于 SQL Hint OceanBase SQL 的执行性能跟 SQL 的执行计划有关，执行计划跟表的连接方式、查询条件和表的索引都有关系，通常这是数据库的 SQL 引擎内部逻辑。通过在 SQL 里添加注释，您可能改变执行计划的内容，从而改变 SQL 的执行性能。SQL Hint 的格式是： ~~~ /*+ hint_text */ ~~~ 常用 SQL Hint 有： * **read\_consistency(weak)**：弱一致性读，指引SQL读取相关表的分区的备副本。 * **index**(*table\_name*,*index\_name*)：指引SQL使用某个表的某个索引读取数据。 * **query\_timeout(int\_num)：**设置当前SQL的查询超时时间，单位是us。 其他常用 SQL Hints 请参考附录**OceanBase 常用 SQL Hints**。 ## 使用 SQL Hint SQL Hint 通常用在 SQL 里，并不限于查询 SQL。这里以查询 SQL 为例，简单的语法格式如下： ~~~ SELECT /*+ hint_text [, hint_text] */ select_items FROM table_name ~~~ **说明** * 多个 SQL Hint 可以叠加使用，注意功能不要冲突。 * 在 obclient 命令行环境下，默认会忽略注释语法，导致 SQL Hint 不起作用，所以启动 obclient 时需要增加参数“-c”。 示例：在查询 SQL 中使用 SQL Hint，下面 SQL 指定查询超时时间为 10 秒。 ~~~ obclient> select /*+ query_timeout(10000000) */ o_id,o_c_id,o_carrier_id,o_ol_cnt,o_all_local,o_entry_d from ordr where o_w_id=1 and o_d_id=2 and o_id=2100; +------+--------+--------------+----------+-------------+------------+ | o_id | o_c_id | o_carrier_id | o_ol_cnt | o_all_local | o_entry_d | +------+--------+--------------+----------+-------------+------------+ | 2100 | 8 | 8 | 11 | 1 | 2020-02-15 | +------+--------+--------------+----------+-------------+------------+ 1 row in set (0.00 sec) obclient> SELECT /*+ no_use_px paratLel(8) */ * FROM( SELECT /*+ no_use_px parallel(8) */ no_w_id, no_d_id, MAX(no_o_id) max_no_o_id, MIN(no_o_id) min_no_o_id, COUNT(*) count_no FROM nord GROUP BY no_w_id, no_d_Id ) x WHERE max_no_o_id - min_no_o_id+ 1!= count_no; Empty set (0.01 sec) obclient> ~~~