plan_filter

使用执行计划代价过滤阻止特定查询语句

概览

扩展包名	版本	分类	许可证	语言
`pg_plan_filter`	`0.0.1`	FEAT	PostgreSQL	C

ID	扩展名	Bin	Lib	Load	Create	Trust	Reloc	模式
2810	`plan_filter`	否	是	是	否	否	否	-

相关扩展	`pg_hint_plan` `pg_kpart` `pg_command_fw` `hypopg` `index_advisor` `pg_qualstats` `online_advisor` `block_copy_command` `pg_stat_plans` `pg_readonly`

版本

类型	仓库	版本	PG 大版本	包名	依赖
EXT	PIGSTY	`0.0.1`	1817161514	`pg_plan_filter`	-
RPM	PIGSTY	`0.0.1`	1817161514	`pg_plan_filter_$v`	-
DEB	PIGSTY	`0.0.1`	1817161514	`postgresql-$v-pg-plan-filter`	-

OS / PG	PG18	PG17	PG16	PG15	PG14
el8.x86_64	PIGSTY 0.0.1 el8.x86_64.pg18 : pg_plan_filter_18 pg_plan_filter_18-0.0.1-1PIGSTY.el8.x86_64.rpm PIGSTY · 0.0.1 · 10.8KiB	PIGSTY 0.0.1 el8.x86_64.pg17 : pg_plan_filter_17 pg_plan_filter_17-0.0.1-1PIGSTY.el8.x86_64.rpm PIGSTY · 0.0.1 · 10.8KiB	PIGSTY 0.0.1 el8.x86_64.pg16 : pg_plan_filter_16 pg_plan_filter_16-0.0.1-1PIGSTY.el8.x86_64.rpm PIGSTY · 0.0.1 · 10.8KiB	PIGSTY 0.0.1 el8.x86_64.pg15 : pg_plan_filter_15 pg_plan_filter_15-0.0.1-1PIGSTY.el8.x86_64.rpm PIGSTY · 0.0.1 · 10.8KiB	PIGSTY 0.0.1 el8.x86_64.pg14 : pg_plan_filter_14 pg_plan_filter_14-0.0.1-1PIGSTY.el8.x86_64.rpm PIGSTY · 0.0.1 · 10.8KiB
el8.aarch64	PIGSTY 0.0.1 el8.aarch64.pg18 : pg_plan_filter_18 pg_plan_filter_18-0.0.1-1PIGSTY.el8.aarch64.rpm PIGSTY · 0.0.1 · 11.0KiB	PIGSTY 0.0.1 el8.aarch64.pg17 : pg_plan_filter_17 pg_plan_filter_17-0.0.1-1PIGSTY.el8.aarch64.rpm PIGSTY · 0.0.1 · 11.0KiB	PIGSTY 0.0.1 el8.aarch64.pg16 : pg_plan_filter_16 pg_plan_filter_16-0.0.1-1PIGSTY.el8.aarch64.rpm PIGSTY · 0.0.1 · 11.0KiB	PIGSTY 0.0.1 el8.aarch64.pg15 : pg_plan_filter_15 pg_plan_filter_15-0.0.1-1PIGSTY.el8.aarch64.rpm PIGSTY · 0.0.1 · 11.0KiB	PIGSTY 0.0.1 el8.aarch64.pg14 : pg_plan_filter_14 pg_plan_filter_14-0.0.1-1PIGSTY.el8.aarch64.rpm PIGSTY · 0.0.1 · 11.0KiB
el9.x86_64	PIGSTY 0.0.1 el9.x86_64.pg18 : pg_plan_filter_18 pg_plan_filter_18-0.0.1-1PIGSTY.el9.x86_64.rpm PIGSTY · 0.0.1 · 10.5KiB	PIGSTY 0.0.1 el9.x86_64.pg17 : pg_plan_filter_17 pg_plan_filter_17-0.0.1-1PIGSTY.el9.x86_64.rpm PIGSTY · 0.0.1 · 10.5KiB	PIGSTY 0.0.1 el9.x86_64.pg16 : pg_plan_filter_16 pg_plan_filter_16-0.0.1-1PIGSTY.el9.x86_64.rpm PIGSTY · 0.0.1 · 10.5KiB	PIGSTY 0.0.1 el9.x86_64.pg15 : pg_plan_filter_15 pg_plan_filter_15-0.0.1-1PIGSTY.el9.x86_64.rpm PIGSTY · 0.0.1 · 10.5KiB	PIGSTY 0.0.1 el9.x86_64.pg14 : pg_plan_filter_14 pg_plan_filter_14-0.0.1-1PIGSTY.el9.x86_64.rpm PIGSTY · 0.0.1 · 10.5KiB
el9.aarch64	PIGSTY 0.0.1 el9.aarch64.pg18 : pg_plan_filter_18 pg_plan_filter_18-0.0.1-1PIGSTY.el9.aarch64.rpm PIGSTY · 0.0.1 · 10.5KiB	PIGSTY 0.0.1 el9.aarch64.pg17 : pg_plan_filter_17 pg_plan_filter_17-0.0.1-1PIGSTY.el9.aarch64.rpm PIGSTY · 0.0.1 · 10.5KiB	PIGSTY 0.0.1 el9.aarch64.pg16 : pg_plan_filter_16 pg_plan_filter_16-0.0.1-1PIGSTY.el9.aarch64.rpm PIGSTY · 0.0.1 · 10.5KiB	PIGSTY 0.0.1 el9.aarch64.pg15 : pg_plan_filter_15 pg_plan_filter_15-0.0.1-1PIGSTY.el9.aarch64.rpm PIGSTY · 0.0.1 · 10.5KiB	PIGSTY 0.0.1 el9.aarch64.pg14 : pg_plan_filter_14 pg_plan_filter_14-0.0.1-1PIGSTY.el9.aarch64.rpm PIGSTY · 0.0.1 · 10.5KiB
el10.x86_64	PIGSTY 0.0.1 el10.x86_64.pg18 : pg_plan_filter_18 pg_plan_filter_18-0.0.1-1PIGSTY.el10.x86_64.rpm PIGSTY · 0.0.1 · 10.4KiB	PIGSTY 0.0.1 el10.x86_64.pg17 : pg_plan_filter_17 pg_plan_filter_17-0.0.1-1PIGSTY.el10.x86_64.rpm PIGSTY · 0.0.1 · 10.5KiB	PIGSTY 0.0.1 el10.x86_64.pg16 : pg_plan_filter_16 pg_plan_filter_16-0.0.1-1PIGSTY.el10.x86_64.rpm PIGSTY · 0.0.1 · 10.5KiB	PIGSTY 0.0.1 el10.x86_64.pg15 : pg_plan_filter_15 pg_plan_filter_15-0.0.1-1PIGSTY.el10.x86_64.rpm PIGSTY · 0.0.1 · 10.5KiB	PIGSTY 0.0.1 el10.x86_64.pg14 : pg_plan_filter_14 pg_plan_filter_14-0.0.1-1PIGSTY.el10.x86_64.rpm PIGSTY · 0.0.1 · 10.5KiB
el10.aarch64	PIGSTY 0.0.1 el10.aarch64.pg18 : pg_plan_filter_18 pg_plan_filter_18-0.0.1-1PIGSTY.el10.aarch64.rpm PIGSTY · 0.0.1 · 10.6KiB	PIGSTY 0.0.1 el10.aarch64.pg17 : pg_plan_filter_17 pg_plan_filter_17-0.0.1-1PIGSTY.el10.aarch64.rpm PIGSTY · 0.0.1 · 10.7KiB	PIGSTY 0.0.1 el10.aarch64.pg16 : pg_plan_filter_16 pg_plan_filter_16-0.0.1-1PIGSTY.el10.aarch64.rpm PIGSTY · 0.0.1 · 10.7KiB	PIGSTY 0.0.1 el10.aarch64.pg15 : pg_plan_filter_15 pg_plan_filter_15-0.0.1-1PIGSTY.el10.aarch64.rpm PIGSTY · 0.0.1 · 10.7KiB	PIGSTY 0.0.1 el10.aarch64.pg14 : pg_plan_filter_14 pg_plan_filter_14-0.0.1-1PIGSTY.el10.aarch64.rpm PIGSTY · 0.0.1 · 10.7KiB
d12.x86_64	PIGSTY 0.0.1 d12.x86_64.pg18 : postgresql-18-pg-plan-filter postgresql-18-pg-plan-filter_0.0.1-1PIGSTY~bookworm_amd64.deb PIGSTY · 0.0.1 · 9.9KiB	PIGSTY 0.0.1 d12.x86_64.pg17 : postgresql-17-pg-plan-filter postgresql-17-pg-plan-filter_0.0.1-1PIGSTY~bookworm_amd64.deb PIGSTY · 0.0.1 · 9.9KiB	PIGSTY 0.0.1 d12.x86_64.pg16 : postgresql-16-pg-plan-filter postgresql-16-pg-plan-filter_0.0.1-1PIGSTY~bookworm_amd64.deb PIGSTY · 0.0.1 · 9.9KiB	PIGSTY 0.0.1 d12.x86_64.pg15 : postgresql-15-pg-plan-filter postgresql-15-pg-plan-filter_0.0.1-1PIGSTY~bookworm_amd64.deb PIGSTY · 0.0.1 · 9.9KiB	PIGSTY 0.0.1 d12.x86_64.pg14 : postgresql-14-pg-plan-filter postgresql-14-pg-plan-filter_0.0.1-1PIGSTY~bookworm_amd64.deb PIGSTY · 0.0.1 · 9.9KiB
d12.aarch64	PIGSTY 0.0.1 d12.aarch64.pg18 : postgresql-18-pg-plan-filter postgresql-18-pg-plan-filter_0.0.1-1PIGSTY~bookworm_arm64.deb PIGSTY · 0.0.1 · 10.1KiB	PIGSTY 0.0.1 d12.aarch64.pg17 : postgresql-17-pg-plan-filter postgresql-17-pg-plan-filter_0.0.1-1PIGSTY~bookworm_arm64.deb PIGSTY · 0.0.1 · 10.1KiB	PIGSTY 0.0.1 d12.aarch64.pg16 : postgresql-16-pg-plan-filter postgresql-16-pg-plan-filter_0.0.1-1PIGSTY~bookworm_arm64.deb PIGSTY · 0.0.1 · 10.0KiB	PIGSTY 0.0.1 d12.aarch64.pg15 : postgresql-15-pg-plan-filter postgresql-15-pg-plan-filter_0.0.1-1PIGSTY~bookworm_arm64.deb PIGSTY · 0.0.1 · 10.1KiB	PIGSTY 0.0.1 d12.aarch64.pg14 : postgresql-14-pg-plan-filter postgresql-14-pg-plan-filter_0.0.1-1PIGSTY~bookworm_arm64.deb PIGSTY · 0.0.1 · 10.0KiB
d13.x86_64	PIGSTY 0.0.1 d13.x86_64.pg18 : postgresql-18-pg-plan-filter postgresql-18-pg-plan-filter_0.0.1-1PIGSTY~trixie_amd64.deb PIGSTY · 0.0.1 · 9.9KiB	PIGSTY 0.0.1 d13.x86_64.pg17 : postgresql-17-pg-plan-filter postgresql-17-pg-plan-filter_0.0.1-1PIGSTY~trixie_amd64.deb PIGSTY · 0.0.1 · 9.9KiB	PIGSTY 0.0.1 d13.x86_64.pg16 : postgresql-16-pg-plan-filter postgresql-16-pg-plan-filter_0.0.1-1PIGSTY~trixie_amd64.deb PIGSTY · 0.0.1 · 9.9KiB	PIGSTY 0.0.1 d13.x86_64.pg15 : postgresql-15-pg-plan-filter postgresql-15-pg-plan-filter_0.0.1-1PIGSTY~trixie_amd64.deb PIGSTY · 0.0.1 · 9.9KiB	PIGSTY 0.0.1 d13.x86_64.pg14 : postgresql-14-pg-plan-filter postgresql-14-pg-plan-filter_0.0.1-1PIGSTY~trixie_amd64.deb PIGSTY · 0.0.1 · 9.8KiB
d13.aarch64	PIGSTY 0.0.1 d13.aarch64.pg18 : postgresql-18-pg-plan-filter postgresql-18-pg-plan-filter_0.0.1-1PIGSTY~trixie_arm64.deb PIGSTY · 0.0.1 · 10.1KiB	PIGSTY 0.0.1 d13.aarch64.pg17 : postgresql-17-pg-plan-filter postgresql-17-pg-plan-filter_0.0.1-1PIGSTY~trixie_arm64.deb PIGSTY · 0.0.1 · 10.1KiB	PIGSTY 0.0.1 d13.aarch64.pg16 : postgresql-16-pg-plan-filter postgresql-16-pg-plan-filter_0.0.1-1PIGSTY~trixie_arm64.deb PIGSTY · 0.0.1 · 10.1KiB	PIGSTY 0.0.1 d13.aarch64.pg15 : postgresql-15-pg-plan-filter postgresql-15-pg-plan-filter_0.0.1-1PIGSTY~trixie_arm64.deb PIGSTY · 0.0.1 · 10.1KiB	PIGSTY 0.0.1 d13.aarch64.pg14 : postgresql-14-pg-plan-filter postgresql-14-pg-plan-filter_0.0.1-1PIGSTY~trixie_arm64.deb PIGSTY · 0.0.1 · 10.1KiB
u22.x86_64	PIGSTY 0.0.1 u22.x86_64.pg18 : postgresql-18-pg-plan-filter postgresql-18-pg-plan-filter_0.0.1-1PIGSTY~jammy_amd64.deb PIGSTY · 0.0.1 · 10.1KiB	PIGSTY 0.0.1 u22.x86_64.pg17 : postgresql-17-pg-plan-filter postgresql-17-pg-plan-filter_0.0.1-1PIGSTY~jammy_amd64.deb PIGSTY · 0.0.1 · 10.6KiB	PIGSTY 0.0.1 u22.x86_64.pg16 : postgresql-16-pg-plan-filter postgresql-16-pg-plan-filter_0.0.1-1PIGSTY~jammy_amd64.deb PIGSTY · 0.0.1 · 10.6KiB	PIGSTY 0.0.1 u22.x86_64.pg15 : postgresql-15-pg-plan-filter postgresql-15-pg-plan-filter_0.0.1-1PIGSTY~jammy_amd64.deb PIGSTY · 0.0.1 · 10.5KiB	PIGSTY 0.0.1 u22.x86_64.pg14 : postgresql-14-pg-plan-filter postgresql-14-pg-plan-filter_0.0.1-1PIGSTY~jammy_amd64.deb PIGSTY · 0.0.1 · 10.5KiB
u22.aarch64	PIGSTY 0.0.1 u22.aarch64.pg18 : postgresql-18-pg-plan-filter postgresql-18-pg-plan-filter_0.0.1-1PIGSTY~jammy_arm64.deb PIGSTY · 0.0.1 · 10.1KiB	PIGSTY 0.0.1 u22.aarch64.pg17 : postgresql-17-pg-plan-filter postgresql-17-pg-plan-filter_0.0.1-1PIGSTY~jammy_arm64.deb PIGSTY · 0.0.1 · 10.6KiB	PIGSTY 0.0.1 u22.aarch64.pg16 : postgresql-16-pg-plan-filter postgresql-16-pg-plan-filter_0.0.1-1PIGSTY~jammy_arm64.deb PIGSTY · 0.0.1 · 10.6KiB	PIGSTY 0.0.1 u22.aarch64.pg15 : postgresql-15-pg-plan-filter postgresql-15-pg-plan-filter_0.0.1-1PIGSTY~jammy_arm64.deb PIGSTY · 0.0.1 · 10.6KiB	PIGSTY 0.0.1 u22.aarch64.pg14 : postgresql-14-pg-plan-filter postgresql-14-pg-plan-filter_0.0.1-1PIGSTY~jammy_arm64.deb PIGSTY · 0.0.1 · 10.6KiB
u24.x86_64	PIGSTY 0.0.1 u24.x86_64.pg18 : postgresql-18-pg-plan-filter postgresql-18-pg-plan-filter_0.0.1-1PIGSTY~noble_amd64.deb PIGSTY · 0.0.1 · 10.1KiB	PIGSTY 0.0.1 u24.x86_64.pg17 : postgresql-17-pg-plan-filter postgresql-17-pg-plan-filter_0.0.1-1PIGSTY~noble_amd64.deb PIGSTY · 0.0.1 · 10.2KiB	PIGSTY 0.0.1 u24.x86_64.pg16 : postgresql-16-pg-plan-filter postgresql-16-pg-plan-filter_0.0.1-1PIGSTY~noble_amd64.deb PIGSTY · 0.0.1 · 10.2KiB	PIGSTY 0.0.1 u24.x86_64.pg15 : postgresql-15-pg-plan-filter postgresql-15-pg-plan-filter_0.0.1-1PIGSTY~noble_amd64.deb PIGSTY · 0.0.1 · 10.2KiB	PIGSTY 0.0.1 u24.x86_64.pg14 : postgresql-14-pg-plan-filter postgresql-14-pg-plan-filter_0.0.1-1PIGSTY~noble_amd64.deb PIGSTY · 0.0.1 · 10.1KiB
u24.aarch64	PIGSTY 0.0.1 u24.aarch64.pg18 : postgresql-18-pg-plan-filter postgresql-18-pg-plan-filter_0.0.1-1PIGSTY~noble_arm64.deb PIGSTY · 0.0.1 · 10.2KiB	PIGSTY 0.0.1 u24.aarch64.pg17 : postgresql-17-pg-plan-filter postgresql-17-pg-plan-filter_0.0.1-1PIGSTY~noble_arm64.deb PIGSTY · 0.0.1 · 10.3KiB	PIGSTY 0.0.1 u24.aarch64.pg16 : postgresql-16-pg-plan-filter postgresql-16-pg-plan-filter_0.0.1-1PIGSTY~noble_arm64.deb PIGSTY · 0.0.1 · 10.3KiB	PIGSTY 0.0.1 u24.aarch64.pg15 : postgresql-15-pg-plan-filter postgresql-15-pg-plan-filter_0.0.1-1PIGSTY~noble_arm64.deb PIGSTY · 0.0.1 · 10.3KiB	PIGSTY 0.0.1 u24.aarch64.pg14 : postgresql-14-pg-plan-filter postgresql-14-pg-plan-filter_0.0.1-1PIGSTY~noble_arm64.deb PIGSTY · 0.0.1 · 10.2KiB
u26.x86_64	PIGSTY 0.0.1 u26.x86_64.pg18 : postgresql-18-pg-plan-filter postgresql-18-pg-plan-filter_0.0.1-1PIGSTY~resolute_amd64.deb PIGSTY · 0.0.1 · 8.8KiB	PIGSTY 0.0.1 u26.x86_64.pg17 : postgresql-17-pg-plan-filter postgresql-17-pg-plan-filter_0.0.1-1PIGSTY~resolute_amd64.deb PIGSTY · 0.0.1 · 8.8KiB	PIGSTY 0.0.1 u26.x86_64.pg16 : postgresql-16-pg-plan-filter postgresql-16-pg-plan-filter_0.0.1-1PIGSTY~resolute_amd64.deb PIGSTY · 0.0.1 · 8.8KiB	PIGSTY 0.0.1 u26.x86_64.pg15 : postgresql-15-pg-plan-filter postgresql-15-pg-plan-filter_0.0.1-1PIGSTY~resolute_amd64.deb PIGSTY · 0.0.1 · 8.8KiB	PIGSTY 0.0.1 u26.x86_64.pg14 : postgresql-14-pg-plan-filter postgresql-14-pg-plan-filter_0.0.1-1PIGSTY~resolute_amd64.deb PIGSTY · 0.0.1 · 8.8KiB
u26.aarch64	PIGSTY 0.0.1 u26.aarch64.pg18 : postgresql-18-pg-plan-filter postgresql-18-pg-plan-filter_0.0.1-1PIGSTY~resolute_arm64.deb PIGSTY · 0.0.1 · 8.9KiB	PIGSTY 0.0.1 u26.aarch64.pg17 : postgresql-17-pg-plan-filter postgresql-17-pg-plan-filter_0.0.1-1PIGSTY~resolute_arm64.deb PIGSTY · 0.0.1 · 8.9KiB	PIGSTY 0.0.1 u26.aarch64.pg16 : postgresql-16-pg-plan-filter postgresql-16-pg-plan-filter_0.0.1-1PIGSTY~resolute_arm64.deb PIGSTY · 0.0.1 · 8.9KiB	PIGSTY 0.0.1 u26.aarch64.pg15 : postgresql-15-pg-plan-filter postgresql-15-pg-plan-filter_0.0.1-1PIGSTY~resolute_arm64.deb PIGSTY · 0.0.1 · 8.9KiB	PIGSTY 0.0.1 u26.aarch64.pg14 : postgresql-14-pg-plan-filter postgresql-14-pg-plan-filter_0.0.1-1PIGSTY~resolute_arm64.deb PIGSTY · 0.0.1 · 8.9KiB

构建

您可以使用 pig build 命令构建 pg_plan_filter 扩展的 RPM / DEB 包：

BASH

pig build pkg pg_plan_filter         # 构建 RPM / DEB 包

安装

您可以直接安装 pg_plan_filter 扩展包的预置二进制包，首先确保 PGDG 和 PIGSTY 仓库已经添加并启用：

BASH

pig repo add pgsql -u          # 添加仓库并更新缓存

使用 pig 或者是 apt/yum/dnf 安装扩展：

安装

BASH

pig install pg_plan_filter;          # 当前活跃 PG 版本安装

pig

BASH

pig ext install -y pg_plan_filter -v 18  # PG 18
pig ext install -y pg_plan_filter -v 17  # PG 17
pig ext install -y pg_plan_filter -v 16  # PG 16
pig ext install -y pg_plan_filter -v 15  # PG 15
pig ext install -y pg_plan_filter -v 14  # PG 14

dnf

BASH

dnf install -y pg_plan_filter_18       # PG 18
dnf install -y pg_plan_filter_17       # PG 17
dnf install -y pg_plan_filter_16       # PG 16
dnf install -y pg_plan_filter_15       # PG 15
dnf install -y pg_plan_filter_14       # PG 14

apt

BASH

apt install -y postgresql-18-pg-plan-filter   # PG 18
apt install -y postgresql-17-pg-plan-filter   # PG 17
apt install -y postgresql-16-pg-plan-filter   # PG 16
apt install -y postgresql-15-pg-plan-filter   # PG 15
apt install -y postgresql-14-pg-plan-filter   # PG 14

预加载配置：

BASH

shared_preload_libraries = 'plan_filter';

用法

plan_filter: 根据执行计划过滤语句

pg_plan_filter 模块在执行前根据配置的条件检查语句，如果违反条件则抛出错误。这允许管理员阻止在生产数据库上执行某些查询。

目前支持的唯一条件是语句计划的最大允许估算成本。

配置

在 postgresql.conf 中添加：

INI

shared_preload_libraries = 'plan_filter'
plan_filter.statement_cost_limit = 100000.0

statement_cost_limit 必须设置为非零值才能启用过滤。默认值为 0（不过滤）。

GUC 参数

参数	类型	默认值	描述
`plan_filter.statement_cost_limit`	float	`0`	最大允许估算计划成本。`0` 表示禁用过滤
`plan_filter.limit_select_only`	bool	`false`	为 true 时仅过滤 `SELECT` 语句

示例

全局阻止高成本查询：

INI

plan_filter.statement_cost_limit = 100000.0

仅限制 SELECT 语句（注意：SELECT != READONLY，因为 SELECT 也可以修改数据）：

INI

plan_filter.limit_select_only = true

当模块以非零 statement_cost_limit 运行时，也会阻止对高成本查询执行 EXPLAIN。临时绕过过滤：

SQL

BEGIN;
SET LOCAL plan_filter.statement_cost_limit = 0;
EXPLAIN SELECT ...;
COMMIT;

按用户覆盖限制：

SQL

ALTER USER can_run_expensive SET plan_filter.statement_cost_limit = 0;
ALTER USER only_cheap_queries SET plan_filter.statement_cost_limit = 10000;

注意事项

statement_cost_limit 基于估算成本取消计划。PostgreSQL 规划器返回的成本估算可能与实际查询执行时间无关。请准备好应对误报取消的情况，并将限制值设置得宽裕一些。

意见反馈

这个页面对您有帮助吗？

感谢反馈！请告诉我们如何改进。

抱歉给您带来不便。请告诉我们如何改进。