文档首页/ 云数据库 GaussDB/ 开发指南（分布式_V2.0-8.x）/ Schema/ DBE_SQL_UTIL Schema/ DBE_SQL_UTIL.create_hint_sql_patch
更新时间：2026-03-23 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
