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 提供,策略仅负责消费这个可信上下文。

sql
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);

预期输出

text
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 直接报错。

sql
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');

预期输出

text
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 组合规则影响。需要读写差异、删除附加条件或不同角色授权时,优先拆成命令级策略,能让权限意图更明确,也更容易独立测试。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

按命令拆分 RLS 策略

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通