PostgreSQL / 系统课时
用 EXPLAIN 观察 RLS 谓词
用 EXPLAIN 观察 RLS 谓词
RLS 生效后,业务 SQL 往往没有显式写 tenant_id,但 PostgreSQL 会把策略条件加入查询。本文用同一条查询对比启用 RLS 前后的 EXPLAIN 与实际执行,确认租户谓词出现在何处,并据此判断过滤、索引和连接顺序是否合理。
学习目标
- 能用
EXPLAIN (VERBOSE)识别 RLS 注入后的实际过滤条件 - 能用
EXPLAIN (ANALYZE, BUFFERS)判断策略谓词是否造成多余扫描 - 能区分“RLS 已生效”和“查询路径已经高效”这两个结论
建立可重复的观察环境
下面用普通应用角色访问表,避免表所有者或带 BYPASSRLS 的角色绕过策略。请在可丢弃测试库中用具备建表、建角色权限的管理角色执行初始化,再把查询权限交给 app_user。
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;预期结果
CREATE ROLE
GRANT ROLE
CREATE TABLE
INSERT 0 6
GRANT如果角色或表已存在,应在独立测试库中换名或先清理对象,不要把这段初始化脚本直接用于生产库。
对比启用 RLS 前后的计划
先关闭 RLS,以 app_user 执行只包含业务条件的查询。VERBOSE 会把实际过滤表达式展开得更完整。
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;预期输出会只体现业务谓词,关键行类似下面这样;节点名称和表达式顺序可能随统计信息与版本不同。
Seq Scan on public.tickets
Filter: (tickets.status = 'open'::text)再启用策略,并通过会话变量指定当前租户。策略本身只负责可见性限制,不要求业务 SQL 再显式追加 tenant_id = 1。
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;预期输出的关键变化是过滤条件同时包含业务谓词与租户谓词。
Seq Scan on public.tickets
Filter: ((tickets.tenant_id = (current_setting('app.tenant_id'::text))::bigint) AND (tickets.status = 'open'::text))用实际执行量判断代价
只看到 RLS 谓词并不能证明路径高效。继续用 ANALYZE 观察实际行数与缓冲区访问量,重点看扫描了多少候选行、最终保留多少行。
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 行;关键结果类似下面这样,缓冲区页数会因环境而不同。
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 的安全性与查询路径都得到了验证。