Files
oceanbase/docs/docs-cn/7.developer-guide-1/2.connect-to-the-oceanbase-database/6.query-table-data/8.use-sql-hints-in-queries.md
2022-02-10 14:51:49 +08:00

2.4 KiB

在查询中使用 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>