PostgreSQL / 系统课时
搭建 PostgreSQL RLS 实验环境
搭建 PostgreSQL RLS 实验环境
本篇用 PostgreSQL 18 搭建一套可反复重建的 RLS 实验环境:启动数据库实例,创建实验库、租户样例表与低权限测试账号,并通过版本、对象所有者和数据查询确认基线可用。
学习目标
- 启动并验证 PostgreSQL 18 实验实例。
- 创建用于 RLS 实验的数据库、样例表和测试账号。
- 确认应用账号不是表所有者,也没有绕过 RLS 的能力。
启动 PostgreSQL 18 实例
下面使用官方 PostgreSQL 18 容器,映射到宿主机 55432 端口。密码仅用于本地实验,不要复用到共享或生产环境。
bash
docker run --name pg18-rls-lab \
-e POSTGRES_PASSWORD='lab-admin-pass' \
-p 55432:5432 \
-d postgres:18
docker exec pg18-rls-lab pg_isready -U postgres预期输出
text
<ID>
/var/run/postgresql:5432 - accepting connections<ID> 是实际容器 ID,会因每次启动而不同。若第二行没有出现 accepting connections,先用 docker logs pg18-rls-lab 检查初始化失败、端口冲突或数据目录权限问题。
创建实验数据库与对象
在全新的实验实例中执行下面脚本。rls_owner 只负责拥有对象,不允许登录;rls_app 和 rls_audit 是后续验证权限与策略的低权限账号,显式保持 NOBYPASSRLS。
bash
docker exec -i pg18-rls-lab psql -U postgres <<'SQL'
CREATE DATABASE rls_lab;
\connect rls_lab
CREATE ROLE rls_owner NOLOGIN NOSUPERUSER NOCREATEDB NOCREATEROLE NOREPLICATION NOBYPASSRLS;
CREATE ROLE rls_app LOGIN PASSWORD 'app-pass' NOSUPERUSER NOCREATEDB NOCREATEROLE NOREPLICATION NOBYPASSRLS;
CREATE ROLE rls_audit LOGIN PASSWORD 'audit-pass' NOSUPERUSER NOCREATEDB NOCREATEROLE NOREPLICATION NOBYPASSRLS;
CREATE SCHEMA lab AUTHORIZATION rls_owner;
SET ROLE rls_owner;
CREATE TABLE lab.tenant_item (
item_id bigint PRIMARY KEY,
tenant_id text NOT NULL,
item_name text NOT NULL
);
INSERT INTO lab.tenant_item (item_id, tenant_id, item_name) VALUES
(101, 'tenant-a', 'alpha'),
(201, 'tenant-b', 'beta');
RESET ROLE;
GRANT USAGE ON SCHEMA lab TO rls_app, rls_audit;
GRANT SELECT, INSERT, UPDATE, DELETE ON lab.tenant_item TO rls_app;
GRANT SELECT ON lab.tenant_item TO rls_audit;
SQL预期输出
text
CREATE DATABASE
You are now connected to database "rls_lab" as user "postgres".
CREATE ROLE
CREATE ROLE
CREATE ROLE
CREATE SCHEMA
SET
CREATE TABLE
INSERT 0 2
RESET
GRANT
GRANT
GRANT这里暂时不启用 RLS。先保留“普通表权限已具备、行级策略尚未介入”的基线,后续才能清楚区分问题来自对象权限还是 RLS 策略。
验证版本、所有者与测试账号
用管理员连接实验库,检查主版本、表所有者以及两个登录角色的 BYPASSRLS 属性。
bash
docker exec -i pg18-rls-lab psql -U postgres -d rls_lab -At <<'SQL'
SELECT current_setting('server_version_num')::int / 10000;
SELECT schemaname || '.' || tablename || ':' || tableowner
FROM pg_tables
WHERE schemaname = 'lab' AND tablename = 'tenant_item';
SELECT rolname || ':bypassrls=' || rolbypassrls
FROM pg_roles
WHERE rolname IN ('rls_app', 'rls_audit')
ORDER BY rolname;
SELECT tenant_id || ':' || item_name
FROM lab.tenant_item
ORDER BY item_id;
SQL预期输出
text
18
lab.tenant_item:rls_owner
rls_app:bypassrls=false
rls_audit:bypassrls=false
tenant-a:alpha
tenant-b:beta第一行应为主版本号 18。更关键的验收点是表由独立的 rls_owner 拥有,应用与审计账号均不能通过 BYPASSRLS 绕过后续策略。
到这里,数据库版本、对象所有权、基础授权和样例数据都已固定,后续启用 RLS、切换租户上下文或测试策略时可以从同一基线判断行为变化。
按自己的节奏,确认真正理解。