pg_strict

概览

版本

构建

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

pig build pkg pg_strict         # 构建 RPM / DEB 包

安装

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

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

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

• 安装
• pig
• dnf
• apt

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

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

dnf install -y pg_strict_18       # PG 18
dnf install -y pg_strict_17       # PG 17
dnf install -y pg_strict_16       # PG 16
dnf install -y pg_strict_15       # PG 15
dnf install -y pg_strict_14       # PG 14

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

预加载配置：

shared_preload_libraries = 'pg_strict';

创建扩展：

CREATE EXTENSION pg_strict;

用法

来源：README, Release v1.0.5, API source

pg_strict 会阻断或警告省略 WHERE 子句的 UPDATE 和 DELETE 语句。它安装 post_parse_analyze_hook，因此必须通过 shared_preload_libraries 加载。

必要设置

-- postgresql.conf
shared_preload_libraries = 'pg_strict'

CREATE EXTENSION pg_strict;

GUC

• pg_strict.require_where_on_update
• pg_strict.require_where_on_delete

每个设置都支持 off、warn 和 on。

SET pg_strict.require_where_on_update = 'on';
SET pg_strict.require_where_on_delete = 'warn';

辅助函数

SELECT pg_strict_version();
SELECT * FROM pg_strict_config();

SELECT pg_strict_check_where_clause('DELETE FROM t', 'DELETE');
SELECT pg_strict_validate_update('UPDATE t SET x = 1 WHERE id = 42');
SELECT pg_strict_validate_delete('DELETE FROM t WHERE id = 42');

SELECT pg_strict_enable_update();
SELECT pg_strict_warn_delete();
SELECT pg_strict_disable_delete();

• pg_strict_set_update_mode(mode) 和 pg_strict_set_delete_mode(mode) 提供通用模式设置函数。
• SET LOCAL 可在事务内用于一次性批量操作。

注意事项

• Enforcement 只检查是否存在 WHERE，不判断意图：任何非空 WHERE 子句都满足规则。
• 只检查 UPDATE 和 DELETE。
• 当前上游 release 是 1.0.5；上游文档记录 PostgreSQL 13 到 18，而 db/extension.csv 中的 Pigsty package row 覆盖 PostgreSQL 14 到 18。
• Pigsty 关于 pgrx 0.17.0 的备注是 packaging/build metadata，不是文档化的用户侧功能变化。