# 使用SQL PATCH进行调优 SQL PATCH主要设计给DBA、运维人员及其他需要对SQL进行调优的角色使用，用户通过其他运维视图或定位手段识别到业务语句存在计划不优导致的性能问题时，可以通过创建SQL PATCH对业务语句进行基于Hint的调优。目前支持行数、扫描方式、连接方式、连接顺序、PBE custom/generic计划选择、语句级参数设置、参数化路径的Hint。此外，对于部分由特定语句触发系统内部问题导致系统可服务性受损的语句，在不对业务语句变更的情况下，也可以通过创建用于单点规避的SQL PATCH，对问题场景提前报错处理，避免更大的损失。 #### 特性约束 1. 仅支持针对Unique SQL ID添加补丁，如果存在Unique SQL ID冲突，用于Hint调优的SQL PATCH可能影响性能，但不影响语义正确性。 2. 仅支持不改变SQL语义的Hint作为PATCH，不支持SQL改写。 3. 不支持逻辑备份、恢复。 4. 不支持创建时校验PATCH合法性，如果PATCH的Hint存在语法或语义错误，不影响查询正确执行。 5. 仅初始用户、运维管理员、监控管理员、系统管理员用户有权限执行。 6. 库之间不共享，创建SQL PATCH时需要连接目标库。 7. 配置集中式备机可读时，需要指定主机执行SQL PATCH创建/修改/删除函数调用，备机执行报错。 8. SQL PATCH同步给备机存在一定延迟，待备机回放相关日志后PATCH生效。 9. 不支持对存储过程中的SQL语句生效，当前机制不会对存储过程内语句生成Unique SQL ID。 10. 使用PREPARE + EXECUTE语法执行的预编译语句不支持使用SQL PATCH。 11. 用于规避的Abort Patch不建议在数据库中长期使用，只应该作为临时规避方法。遇到内核问题所导致的特定语句触发数据库服务不可用问题，需要尽快修改业务或升级内核版本解决问题。并且升级后由于Unique SQL ID生成方法可能变化，可能导致规避方法失效。 12. 当前，除DML语句之外，其他SQL语句（如CREATE TABLE等）的Unique SQL ID是对语句文本直接哈希生成的，所以对于此类语句，SQL PATCH对大小写、空格、换行等敏感，即不同的文本的语句，即使语义相对，仍然需要对应不同的SQL PATCH。对于DML，则同一个SQL PATCH可以对不同入参的语句生效，并且忽略大小写和空格。 #### 示例 SQL PATCH的实现当前基于Unique SQL ID，所以需要打开相关的运维参数才可以生效（enable_resource_track = on，instr_unique_sql_count \> 0），Unique SQL ID在WDR报告和慢SQL视图中都可以获取到，在创建SQL PATCH时需要指定Unique SQL ID。 下面给出简单的使用样例。 场景一：使用SQL PATCH对特定语句进行Hint调优。 ``` openGauss=# create table hint_t1(a int); CREATE TABLE openGauss=# create index on hint_t1(a); CREATE INDEX openGauss=# set track_stmt_stat_level = 'L1,L1'; --打开FullSQL统计信息 SET openGauss=# select * from hint_t1 t1 where t1.a = 1; --执行SQL语句 a | b | c ---+---+--- 1 | 1 | 1 (1 row) openGauss=# select unique_query_id, query, query_plan from dbe_perf.statement_history where query like '%hint_t1%'; --获取查询计划和Unique SQL ID -[ RECORD 1 ]---+---------------------------------------------------------------------------------------------- unique_query_id | 2578396627 query | select * from hint_t1 t1 where t1.a = ?; query_plan | Datanode Name: sgnode | Bitmap Heap Scan on hint_t1 t1 (cost=4.33..15.70 rows=10 p-time=0 p-rows=0 width=12) | Recheck Cond: (a = '***') | -> Bitmap Index Scan on hint_t1_a_idx (cost=0.00..4.33 rows=10 p-time=0 p-rows=0 width=0) | Index Cond: (a = '***') | | openGauss=# select * from dbe_sql_util.create_hint_sql_patch('patch1', 2578396627, 'indexscan(t1)'); -- 对指定的Unique SQL ID指定Hint Patch -[ RECORD 1 ]---------+-- create_hint_sql_patch | t openGauss=# explain select * from hint_t1 t1 where t1.a = 1; -- 通过explain可以确认Hint是否生效 NOTICE: Plan influenced by SQL hint patch QUERY PLAN ----------------------------------------------------------------------------------- [Bypass] Index Scan using hint_t1_a_idx on hint_t1 t1 (cost=0.00..32.43 rows=10 width=12) Index Cond: (a = 1) (3 rows) openGauss=# select * from hint_t1 t1 where t1.a = 1; -- 再次执行语句 a | b | c ---+---+--- 1 | 1 | 1 (1 row) openGauss=# select unique_query_id, query, query_plan from dbe_perf.statement_history where query like '%hint_t1%'; -- 可以看到新的执行记录计划已改变 -[ RECORD 1 ]---+-------------------------------------------------------------------------------------------------- unique_query_id | 2578396627 query | select * from hint_t1 t1 where t1.a = ?; query_plan | Datanode Name: sgnode | Bitmap Heap Scan on hint_t1 t1 (cost=4.33..15.70 rows=10 p-time=0 p-rows=0 width=12) | Recheck Cond: (a = '***') | -> Bitmap Index Scan on hint_t1_a_idx (cost=0.00..4.33 rows=10 p-time=0 p-rows=0 width=0) | Index Cond: (a = '***') | | -[ RECORD 2 ]---+-------------------------------------------------------------------------------------------------- unique_query_id | 2578396627 query | select * from hint_t1 t1 where t1.a = ?; query_plan | Datanode Name: sgnode | Index Scan using hint_t1_a_idx on hint_t1 t1 (cost=0.00..8.27 rows=1 p-time=0 p-rows=0 width=12) | Index Cond: (a = '***') | | ``` 场景二：使用SQL PATCH对特定语句进行提前报错规避。 ``` openGauss=# select * from dbe_sql_util.drop_sql_patch('patch1'); -- 删去patch1 drop_sql_patch ---------------- t (1 row) openGauss=# select * from dbe_sql_util.create_abort_sql_patch('patch2', 2578396627); 对该语句的Unique SQL ID创建Abort Patch create_abort_sql_patch ------------------------ t (1 row) openGauss=# select * from hint_t1 t1 where t1.a = 1; -- 再次执行语句会提前报错 ERROR: Statement 2578396627 canceled by abort patch patch2 ``` #### 相关链接 SQL PATCH相关系统表、接口函数见下表。 表1SQL PATCH相关系统表、接口函数介绍 | 名称 || 说明 | |:---|---|:---| | 系统表 | [GS_SQL_PATCH](https://support.huaweicloud.com/centralized-devg-v2-gaussdb/gaussdb_42_0641.html#ZH-CN_TOPIC_0000002186176106) | GS_SQL_PATCH系统表存储所有SQL_PATCH的状态信息。 | | 接口函数 [DBE_SQL_UTIL Schema](https://support.huaweicloud.com/centralized-devg-v2-gaussdb/gaussdb_42_1141.html#ZH-CN_TOPIC_0000002221497497) | [DBE_SQL_UTIL.create_hint_sql_patch](https://support.huaweicloud.com/centralized-devg-v2-gaussdb/gaussdb_42_1142.html#ZH-CN_TOPIC_0000002221383065) | create_hint_sql_patch是用于创建调优SQL PATCH的接口函数，返回执行是否成功。 | | 接口函数 [DBE_SQL_UTIL Schema](https://support.huaweicloud.com/centralized-devg-v2-gaussdb/gaussdb_42_1141.html#ZH-CN_TOPIC_0000002221497497) | [DBE_SQL_UTIL.create_abort_sql_patch](https://support.huaweicloud.com/centralized-devg-v2-gaussdb/gaussdb_42_1143.html#ZH-CN_TOPIC_0000002186017374) | create_abort_sql_patch是用于创建避险SQL PATCH的接口函数，返回执行是否成功。 | | 接口函数 [DBE_SQL_UTIL Schema](https://support.huaweicloud.com/centralized-devg-v2-gaussdb/gaussdb_42_1141.html#ZH-CN_TOPIC_0000002221497497) | [DBE_SQL_UTIL.drop_sql_patch](https://support.huaweicloud.com/centralized-devg-v2-gaussdb/gaussdb_42_1144.html#ZH-CN_TOPIC_0000002186177006) | drop_sql_patch是用于在当前建连的CN上删除SQL PATCH的接口函数，返回执行是否成功。 | | 接口函数 [DBE_SQL_UTIL Schema](https://support.huaweicloud.com/centralized-devg-v2-gaussdb/gaussdb_42_1141.html#ZH-CN_TOPIC_0000002221497497) | [DBE_SQL_UTIL.enable_sql_patch](https://support.huaweicloud.com/centralized-devg-v2-gaussdb/gaussdb_42_1145.html#ZH-CN_TOPIC_0000002221497501) | enable_sql_patch是用于在当前建连的CN上开启SQL PATCH的接口函数，返回执行是否成功。 | | 接口函数 [DBE_SQL_UTIL Schema](https://support.huaweicloud.com/centralized-devg-v2-gaussdb/gaussdb_42_1141.html#ZH-CN_TOPIC_0000002221497497) | [DBE_SQL_UTIL.disable_sql_patch](https://support.huaweicloud.com/centralized-devg-v2-gaussdb/gaussdb_42_1146.html#ZH-CN_TOPIC_0000002221383069) | disable_sql_patch是用于在当前建连的CN上禁用SQL PATCH的接口函数，返回执行是否成功。 | | 接口函数 [DBE_SQL_UTIL Schema](https://support.huaweicloud.com/centralized-devg-v2-gaussdb/gaussdb_42_1141.html#ZH-CN_TOPIC_0000002221497497) | [DBE_SQL_UTIL.show_sql_patch](https://support.huaweicloud.com/centralized-devg-v2-gaussdb/gaussdb_42_1147.html#ZH-CN_TOPIC_0000002186017378) | show_sql_patch是用于显示给定patch_name对应的SQL PATCH的接口函数，返回运行结果。 |