safeupdate

强制在 UPDATE 和 DELETE 时提供 Where 条件

概览

扩展包名版本分类许可证语言
safeupdate1.5ADMINISCC
ID扩展名BinLibLoadCreateTrustReloc模式
5820safeupdate-
相关扩展pg_readonly pg_upless pg_savior pg_permissions pgaudit set_user login_hook noset

版本

类型仓库版本PG 大版本包名依赖
EXTPGDG1.51817161514safeupdate-
RPMPGDG1.51817161514safeupdate_$v-
DEBPIGSTY1.51817161514postgresql-$v-pg-safeupdate-
OS / PGPG18PG17PG16PG15PG14
el8.x86_64
el8.aarch64
el9.x86_64
el9.aarch64
el10.x86_64
el10.aarch64
d12.x86_64
PIGSTY 1.5
PIGSTY 1.5
PIGSTY 1.5
PIGSTY 1.5
PIGSTY 1.5
d12.aarch64
PIGSTY 1.5
PIGSTY 1.5
PIGSTY 1.5
PIGSTY 1.5
PIGSTY 1.5
d13.x86_64
PIGSTY 1.5
PIGSTY 1.5
PIGSTY 1.5
PIGSTY 1.5
PIGSTY 1.5
d13.aarch64
PIGSTY 1.5
PIGSTY 1.5
PIGSTY 1.5
PIGSTY 1.5
PIGSTY 1.5
u22.x86_64
PIGSTY 1.5
PIGSTY 1.5
PIGSTY 1.5
PIGSTY 1.5
PIGSTY 1.5
u22.aarch64
PIGSTY 1.5
PIGSTY 1.5
PIGSTY 1.5
PIGSTY 1.5
PIGSTY 1.5
u24.x86_64
PIGSTY 1.5
PIGSTY 1.5
PIGSTY 1.5
PIGSTY 1.5
PIGSTY 1.5
u24.aarch64
PIGSTY 1.5
PIGSTY 1.5
PIGSTY 1.5
PIGSTY 1.5
PIGSTY 1.5

构建

您可以使用 pig build 命令构建 safeupdate 扩展的 DEB 包:

pig build pkg safeupdate         # 构建 DEB 包

安装

您可以直接安装 safeupdate 扩展包的预置二进制包,首先确保 PGDG 仓库已经添加并启用:

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

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

pig install safeupdate;          # 当前活跃 PG 版本安装
pig ext install -y safeupdate -v 18  # PG 18
pig ext install -y safeupdate -v 17  # PG 17
pig ext install -y safeupdate -v 16  # PG 16
pig ext install -y safeupdate -v 15  # PG 15
pig ext install -y safeupdate -v 14  # PG 14
dnf install -y safeupdate_18       # PG 18
dnf install -y safeupdate_17       # PG 17
dnf install -y safeupdate_16       # PG 16
dnf install -y safeupdate_15       # PG 15
dnf install -y safeupdate_14       # PG 14
apt install -y postgresql-18-pg-safeupdate   # PG 18
apt install -y postgresql-17-pg-safeupdate   # PG 17
apt install -y postgresql-16-pg-safeupdate   # PG 16
apt install -y postgresql-15-pg-safeupdate   # PG 15
apt install -y postgresql-14-pg-safeupdate   # PG 14

预加载配置

shared_preload_libraries = 'safeupdate';

用法

safeupdate: 要求 UPDATE 和 DELETE 必须带条件

safeupdate 扩展通过在执行不带 WHERE 子句的 UPDATEDELETE 语句时抛出错误来防止意外的批量数据变更。

激活

-- 会话级别
LOAD 'safeupdate';

-- 数据库级别(持久化)
ALTER DATABASE mydb SET session_preload_libraries = 'safeupdate';

-- 全局(所有数据库,需要重启)
-- shared_preload_libraries = 'safeupdate'   -- 在 postgresql.conf 中

行为

-- 阻止:不带 WHERE 的 UPDATE
UPDATE rack SET fan_speed = 70;
-- ERROR: UPDATE requires a WHERE clause

-- 阻止:不带 WHERE 的 DELETE
DELETE FROM rack;
-- ERROR: DELETE requires a WHERE clause

-- 允许:带 WHERE 子句
UPDATE rack SET fan_speed = 90 WHERE fan_speed = 70;

-- 变通方法:显式的恒真条件
UPDATE rack SET fan_speed = 90 WHERE 1 = 1;

管理员覆盖

-- 在当前会话中临时禁用保护
SET safeupdate.enabled = 0;

基于 CTE 的不带 WHERE 条件的修改也会被阻止。该扩展对于 PostgREST 或其他提供直接数据库写入访问的系统特别有用。


最后修改 2026-03-14: update extension metadata (953cbd0)