PostgreSQL / 系统课时

用复合唯一键隔离业务标识

用复合唯一键隔离业务标识

共享表中,sku、用户名、项目代号等业务标识往往只要求“租户内唯一”。本课把 tenant_id 纳入候选键,用数据库约束直接表达这个边界,并验证不同租户可复用同一标识、同一租户不能重复。

学习目标

  • 判断一个业务唯一性究竟是全局唯一还是租户内唯一
  • 使用 UNIQUE (tenant_id, business_key) 建立租户作用域候选键
  • 理解复合唯一键与 RLS、索引及后续外键设计的关系

先把唯一性的作用域写进模型

在共享表里直接声明 UNIQUE (sku),含义是整张表只能出现一次该 SKU。即使 RLS 让租户 A 看不到租户 B 的行,唯一约束仍由数据库全表检查;租户 B 已使用的值仍可能让租户 A 的插入失败。

如果业务规则是“每个租户内部 SKU 唯一”,真正的候选键应是 (tenant_id, sku)。这样 SKU-001 可以分别属于多个租户,但同一租户不能创建第二条 SKU-001。

用复合唯一约束表达租户内唯一

下面的实验表同时使用复合主键和复合唯一键。主键标识记录实例,uq_lesson_tenant_product_sku 则表达业务上的“租户内 SKU 唯一”。

sql
BEGIN;

CREATE TEMP TABLE lesson_tenant_product (
    tenant_id  bigint NOT NULL,
    product_id bigint GENERATED ALWAYS AS IDENTITY,
    sku        text NOT NULL,
    name       text NOT NULL,
    PRIMARY KEY (tenant_id, product_id),
    CONSTRAINT uq_lesson_tenant_product_sku UNIQUE (tenant_id, sku)
);

INSERT INTO lesson_tenant_product (tenant_id, sku, name)
VALUES
    (101, 'SKU-001', '租户101的标准版'),
    (202, 'SKU-001', '租户202的标准版');

INSERT INTO lesson_tenant_product (tenant_id, sku, name)
VALUES (101, 'SKU-001', '重复记录')
ON CONFLICT (tenant_id, sku) DO NOTHING;

SELECT tenant_id, sku, name
FROM lesson_tenant_product
ORDER BY tenant_id;

ROLLBACK;

预期结果以最终查询为准;不同客户端显示的 BEGIN、INSERT、ROLLBACK 状态行可能不同。

text
 tenant_id |   sku   |       name
-----------+---------+--------------------
       101 | SKU-001 | 租户101的标准版
       202 | SKU-001 | 租户202的标准版
(2 rows)

第三次插入仍使用租户 101 和 SKU-001,因此命中复合唯一约束并被 ON CONFLICT 忽略;租户 202 使用同一个 SKU 则不冲突。如果去掉 ON CONFLICT,对应语句会得到唯一约束冲突,SQLSTATE 为 23505。

让查询和约束使用同一键顺序

PostgreSQL 为唯一约束创建唯一 B-tree 索引,因此 (tenant_id, sku) 也适合常见的租户内点查。查询条件同时包含 tenant_id 与 sku 时,数据库可以直接利用这棵唯一索引;在共享表中,把租户列放在前面也符合“先缩小租户,再定位业务键”的访问模式。

不要仅为追求统一而删除真正的全局唯一规则。例如支付平台生成的全局幂等键如果业务定义就是跨租户唯一,应继续使用全局约束。关键不是“所有唯一键都加 tenant_id”,而是让约束精确对应业务唯一性的作用域。

为后续关系约束留下候选键

复合唯一键不只解决重复值问题,还能成为外键引用的候选键。若子表需要证明“它引用的是同一租户下的父记录”,父表必须存在可被引用的 (tenant_id, business_id) 主键或唯一约束。

因此,建共享表时应优先明确两个问题:记录的实例身份是什么,以及业务标识在哪个范围内唯一。把这两个边界落实到键约束后,RLS 才是在正确数据模型之上的访问控制,而不是弥补错误唯一性设计的补丁。

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

目录与阅读设置

阅读设置

17

记录一个想法

用复合唯一键隔离业务标识

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

登录哪都通