PostgreSQL / 系统课时
按命令拆分 RLS 策略
按命令拆分 RLS 策略
多租户表的读、增、改、删往往不是同一条授权规则。把所有逻辑塞进 FOR ALL 虽然省代码,却容易把不同命令的边界绑死。本课用命令级策略分别约束 SELECT、INSERT、UPDATE、DELETE,并验证每条策略实际控制什么。
学习目标
- 判断四类 DML 命令分别需要
USING、WITH CHECK还是两者 - 为同一张租户表拆分可独立演进的命令级策略
- 理解
FOR ALL与命令级策略同时存在时不是简单覆盖关系
先把四类命令对上策略表达式
SELECT 只读取现有行,因此使用 USING。INSERT 没有旧行可筛选,只允许使用 WITH CHECK。UPDATE 既要决定旧行是否可修改,又要检查新行是否合法,所以同时使用两者。DELETE 只需要判断现有行能否成为删除目标,因此使用 USING。
| 命令 | 旧行筛选 | 新行校验 | 常见用途 |
|---|---|---|---|
SELECT |
USING |
不适用 | 控制可见租户范围 |
INSERT |
不适用 | WITH CHECK |
阻止写入其他租户 |
UPDATE |
USING |
WITH CHECK |
限制目标行并防止改租户 |
DELETE |
USING |
不适用 | 限制可删除的旧行 |
为每个命令建立独立策略
下面先准备两条不同租户的数据,再启用 RLS。租户上下文仍由 app.tenant_id 提供,策略仅负责消费这个可信上下文。
CREATE TABLE documents (
id bigint PRIMARY KEY,
tenant_id bigint NOT NULL,
title text NOT NULL,
status text NOT NULL
);
INSERT INTO documents VALUES
(1, 10, 'tenant-10-doc', 'draft'),
(2, 20, 'tenant-20-doc', 'draft');
CREATE ROLE document_app NOLOGIN;
GRANT document_app TO CURRENT_USER;
GRANT SELECT, INSERT, UPDATE, DELETE ON documents TO document_app;
ALTER TABLE documents ENABLE ROW LEVEL SECURITY;
CREATE POLICY documents_select ON documents
FOR SELECT TO document_app
USING (tenant_id = current_setting('app.tenant_id', true)::bigint);
CREATE POLICY documents_insert ON documents
FOR INSERT TO document_app
WITH CHECK (tenant_id = current_setting('app.tenant_id', true)::bigint);
CREATE POLICY documents_update ON documents
FOR UPDATE TO document_app
USING (tenant_id = current_setting('app.tenant_id', true)::bigint)
WITH CHECK (tenant_id = current_setting('app.tenant_id', true)::bigint);
CREATE POLICY documents_delete ON documents
FOR DELETE TO document_app
USING (tenant_id = current_setting('app.tenant_id', true)::bigint);预期输出
CREATE TABLE
INSERT 0 2
CREATE ROLE
GRANT ROLE
GRANT
ALTER TABLE
CREATE POLICY
CREATE POLICY
CREATE POLICY
CREATE POLICY命令级策略的价值不只是“写得更长”。以后若业务改成“所有租户只能删除 draft 文档”,只需收紧 documents_delete;读策略和更新策略可以保持不变,审计时也能直接看出每类操作的授权意图。
用应用角色验证四条策略
把当前租户设置为 10 后,查询只能看到租户 10 的文档;更新自己的文档成功;删除租户 20 的行会因为旧行不可见而影响 0 行;跨租户插入则因为新行不满足 WITH CHECK 直接报错。
SET ROLE document_app;
SET app.tenant_id = '10';
SELECT id, tenant_id, title
FROM documents
ORDER BY id;
UPDATE documents
SET title = 'tenant-10-doc-updated'
WHERE id = 1;
DELETE FROM documents
WHERE id = 2;
INSERT INTO documents (id, tenant_id, title, status)
VALUES (3, 20, 'forbidden', 'draft');预期输出
SET
SET
id | tenant_id | title
----+-----------+---------------
1 | 10 | tenant-10-doc
(1 row)
UPDATE 1
DELETE 0
ERROR: new row violates row-level security policy for table "documents"这里体现了两种不同失败语义:USING 不满足时,目标旧行通常被过滤,因此 DELETE 返回 0 行;WITH CHECK 不满足时,候选新行被判定非法,因此 INSERT 报错。
什么时候使用 FOR ALL
当四类命令确实共享同一套行级边界时,FOR ALL 可以减少重复;对可同时使用 USING 和 WITH CHECK 的 ALL 策略,如果省略 WITH CHECK,PostgreSQL 会用 USING 表达式作为写入结果校验。
但不要把 FOR ALL 当成命令级策略的“默认规则后再被覆盖”。同一命令可能同时命中 ALL 策略和更具体的策略,最终还会受 permissive 与 restrictive 组合规则影响。需要读写差异、删除附加条件或不同角色授权时,优先拆成命令级策略,能让权限意图更明确,也更容易独立测试。