pg_hint_plan
添加强制指定执行计划的能力
仓库
ossc-db/pg_hint_plan
https://github.com/ossc-db/pg_hint_plan
源码
pg_hint_plan-REL18_1_8_0.tar.gz
pg_hint_plan-REL18_1_8_0.tar.gz
概览
| 扩展包名 | 版本 | 分类 | 许可证 | 语言 |
|---|---|---|---|---|
pg_hint_plan | 1.8.0 | FEAT | BSD-3-Clause | C |
| ID | 扩展名 | Bin | Lib | Load | Create | Trust | Reloc | 模式 |
|---|---|---|---|---|---|---|---|---|
| 2780 | pg_hint_plan | 否 | 是 | 是 | 是 | 否 | 否 | hint_plan |
| 相关扩展 | hypopg online_advisor pg_qualstats index_advisor pg_stat_plans plan_filter pg_strom pg_orca pg_regresql pg_track_optimizer |
|---|
版本
| 类型 | 仓库 | 版本 | PG 大版本 | 包名 | 依赖 |
|---|---|---|---|---|---|
| EXT | PGDG | 1.8.0 | 1817161514 | pg_hint_plan | - |
| RPM | PGDG | 1.8.0 | 1817161514 | pg_hint_plan_$v | - |
| DEB | PGDG | 1.8.0 | 1817161514 | postgresql-$v-pg-hint-plan | - |
安装
您可以直接安装 pg_hint_plan 扩展包的预置二进制包,首先确保 PGDG 仓库已经添加并启用:
BASH
使用 pig 或者是 apt/yum/dnf 安装扩展:
安装
BASH
pig
BASH
dnf
BASH
apt
BASH
预加载配置:
BASH
创建扩展:
SQL
用法
pg_hint_plan 通过 SQL 注释提示覆盖 PostgreSQL 查询规划器的决策,允许你强制指定扫描方法、连接策略和连接顺序。
提示语法
提示嵌入在以 /*+ 开头、*/ 结尾的 SQL 注释中:
SQL
扫描方法提示
| 提示 | 描述 |
|---|---|
SeqScan(table) | 强制顺序扫描 |
IndexScan(table [index...]) | 强制索引扫描(可选限定特定索引) |
IndexOnlyScan(table [index...]) | 强制仅索引扫描 |
BitmapScan(table [index...]) | 强制位图扫描 |
TidScan(table) | 强制 TID 扫描 |
NoSeqScan(table) | 禁止顺序扫描 |
NoIndexScan(table) | 禁止索引扫描和仅索引扫描 |
NoIndexOnlyScan(table) | 禁止仅索引扫描 |
NoBitmapScan(table) | 禁止位图扫描 |
NoTidScan(table) | 禁止 TID 扫描 |
IndexScanRegexp(table [regexp...]) | 使用正则表达式匹配索引名的强制索引扫描 |
DisableIndex(table index...) | 在规划期间禁用特定索引 |
连接方法提示
| 提示 | 描述 |
|---|---|
NestLoop(t1 t2 [t3...]) | 强制嵌套循环连接 |
HashJoin(t1 t2 [t3...]) | 强制哈希连接 |
MergeJoin(t1 t2 [t3...]) | 强制归并连接 |
NoNestLoop(t1 t2 [t3...]) | 禁止嵌套循环连接 |
NoHashJoin(t1 t2 [t3...]) | 禁止哈希连接 |
NoMergeJoin(t1 t2 [t3...]) | 禁止归并连接 |
Memoize(t1 t2 [t3...]) | 允许缓存内层结果 |
NoMemoize(t1 t2 [t3...]) | 禁止缓存 |
连接顺序提示
SQL
行数修正
SQL
并行查询控制
SQL
GUC 参数覆盖
SQL
GUC 配置
| 参数 | 描述 | 默认值 |
|---|---|---|
pg_hint_plan.enable_hint | 全局启用或禁用提示 | on |
pg_hint_plan.enable_hint_table | 启用基于查询的提示表 | off |
pg_hint_plan.debug_print | 打印已应用提示的调试信息 | off |
pg_hint_plan.parse_messages | 提示解析消息的日志级别 | INFO |
pg_hint_plan.message_level | 调试消息的日志级别 | LOG |