PostgreSQL / 系统课时

用 EXPLAIN 观察 RLS 谓词

用 EXPLAIN 观察 RLS 谓词

RLS 生效后,业务 SQL 往往没有显式写 tenant_id,但 PostgreSQL 会把策略条件加入查询。本文用同一条查询对比启用 RLS 前后的 EXPLAIN 与实际执行,确认租户谓词出现在何处,并据此判断过滤、索引和连接顺序是否合理。

学习目标

  • 能用 EXPLAIN (VERBOSE) 识别 RLS 注入后的实际过滤条件
  • 能用 EXPLAIN (ANALYZE, BUFFERS) 判断策略谓词是否造成多余扫描
  • 能区分“RLS 已生效”和“查询路径已经高效”这两个结论

建立可重复的观察环境

下面用普通应用角色访问表,避免表所有者或带 BYPASSRLS 的角色绕过策略。请在可丢弃测试库中用具备建表、建角色权限的管理角色执行初始化,再把查询权限交给 app_user。

sql
CREATE ROLE app_user NOLOGIN;
GRANT app_user TO CURRENT_USER;

CREATE TABLE tickets (
    id bigint GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
    tenant_id bigint NOT NULL,
    status text NOT NULL,
    created_at timestamptz NOT NULL
);

INSERT INTO tickets (tenant_id, status, created_at) VALUES
(1, 'open',   '2026-09-01 00:01+00'),
(1, 'open',   '2026-09-01 00:02+00'),
(1, 'closed', '2026-09-01 00:03+00'),
(2, 'open',   '2026-09-01 00:04+00'),
(2, 'closed', '2026-09-01 00:05+00'),
(3, 'open',   '2026-09-01 00:06+00');

GRANT SELECT ON tickets TO app_user;

预期结果

text
CREATE ROLE
GRANT ROLE
CREATE TABLE
INSERT 0 6
GRANT

如果角色或表已存在,应在独立测试库中换名或先清理对象,不要把这段初始化脚本直接用于生产库。

对比启用 RLS 前后的计划

先关闭 RLS,以 app_user 执行只包含业务条件的查询。VERBOSE 会把实际过滤表达式展开得更完整。

sql
ALTER TABLE tickets DISABLE ROW LEVEL SECURITY;

SET ROLE app_user;

EXPLAIN (VERBOSE, COSTS OFF)
SELECT id, status
FROM tickets
WHERE status = 'open';

RESET ROLE;

预期输出会只体现业务谓词,关键行类似下面这样;节点名称和表达式顺序可能随统计信息与版本不同。

text
Seq Scan on public.tickets
  Filter: (tickets.status = 'open'::text)

再启用策略,并通过会话变量指定当前租户。策略本身只负责可见性限制,不要求业务 SQL 再显式追加 tenant_id = 1。

sql
ALTER TABLE tickets ENABLE ROW LEVEL SECURITY;

CREATE POLICY tenant_isolation ON tickets
USING (tenant_id = current_setting('app.tenant_id')::bigint);

SET ROLE app_user;
SET app.tenant_id = '1';

EXPLAIN (VERBOSE, COSTS OFF)
SELECT id, status
FROM tickets
WHERE status = 'open';

RESET ROLE;

预期输出的关键变化是过滤条件同时包含业务谓词与租户谓词。

text
Seq Scan on public.tickets
  Filter: ((tickets.tenant_id = (current_setting('app.tenant_id'::text))::bigint) AND (tickets.status = 'open'::text))

用实际执行量判断代价

只看到 RLS 谓词并不能证明路径高效。继续用 ANALYZE 观察实际行数与缓冲区访问量,重点看扫描了多少候选行、最终保留多少行。

sql
SET ROLE app_user;
SET app.tenant_id = '1';

EXPLAIN (
    ANALYZE,
    BUFFERS,
    VERBOSE,
    COSTS OFF,
    TIMING OFF,
    SUMMARY OFF
)
SELECT id, status
FROM tickets
WHERE status = 'open';

RESET ROLE;

在这组固定数据下,租户 1 最终返回 2 行;关键结果类似下面这样,缓冲区页数会因环境而不同。

text
Seq Scan on public.tickets (actual rows=2 loops=1)
  Filter: ((tickets.tenant_id = (current_setting('app.tenant_id'::text))::bigint) AND (tickets.status = 'open'::text))
  Rows Removed by Filter: 4
  Buffers: shared hit=<VALUE>

这里 Rows Removed by Filter: 4 说明当前计划先扫描了表中的 6 行,再过滤掉其他租户和状态不匹配的 4 行。RLS 是正确的,但数据量增大后,这种“先扫描、后过滤”的路径可能需要索引优化。

读取复杂计划时先看三处

遇到连接查询时,不要只盯最上层节点。先确认租户条件落在什么位置:进入 Index Cond 通常意味着可以用索引缩小候选集合;停留在 Filter 往往表示已经读到更多行之后才过滤;如果连接顺序导致大表先被广泛扫描,则要同时检查连接键与租户键的索引设计。

还要注意,策略中的函数会参与优化器判断。简单、稳定、可索引的等值条件更容易得到可预测的计划;把复杂函数、跨表子查询或高成本表达式塞进策略,会让每次查询都承担额外优化与执行成本。

当计划同时满足“租户谓词确实存在”和“扫描范围在租户边界内尽早收缩”时,才能认为 RLS 的安全性与查询路径都得到了验证。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 EXPLAIN 观察 RLS 谓词

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

登录哪都通