文档首页/
云数据库 GaussDB/
开发指南（分布式_V2.0-8.x）/
Schema/
DBE_SQL_UTIL Schema/
DBE_SQL_UTIL.create_hint_sql_patch
更新时间：2026-02-06 GMT+08:00
DBE_SQL_UTIL.create_hint_sql_patch
create_hint_sql_patch是用于在当前建立连接的CN上创建调优SQL PATCH的接口函数，返回执行是否成功，如表1所示。
限制：仅初始用户、sysadmin、opradmin和monadmin用户有权限调用。
- CN之间SQL PATCH不共享，要在各个CN上单独创建。
- 开启负载均衡场景或者需要指定创建的CN的场景，推荐使用DBE_SQL_UTIL.create_remote_hint_sql_patch接口进行创建。
- query_string传入EXECUTE语句时，系统会获取当前会话对应的PREPARE语句，并创建SQL PATCH。如果此时没有对应的PREPARE语句，则无效。
|
参数 |
类型 |
描述 |
|---|---|---|
|
patch_name |
IN name |
PATCH名称。 |
|
unique_sql_id |
IN bigint |
查询全局唯一id。 |
|
hint_string |
IN text |
Hint文本。 |
|
description |
IN text |
PATCH的备注，默认值为NULL。 |
|
enabled |
IN bool |
PATCH是否生效，默认值为true。 |
|
query_string |
IN text |
SQL HASH对应的原SQL，默认值为NULL。 |
|
is_sql_hash |
IN bool |
是否是基于SQL HASH创建的PATCH，默认值为false。 |
|
result |
OUT bool |
执行是否成功。 |
父主题： DBE_SQL_UTIL Schema
