架构与系统设计 / 系统课时
唯一约束与联合索引
唯一约束与联合索引
本课解决多租户表中两个常见问题:业务编号被全局唯一约束错误限制,以及查询虽带 tenant_id 却无法高效使用索引。你将通过可执行 SQL 建立租户级唯一键,并根据真实查询条件设计联合索引和验证执行计划。
学习目标
- 将租户维度正确纳入业务唯一约束
- 按高频查询的等值、范围和排序条件设计联合索引
- 使用
EXPLAIN验证索引是否被实际使用
建立租户级唯一约束
在 SaaS 系统中,订单号、商品编码和客户编号通常只要求“同一租户内唯一”。若只对 order_no 建立唯一索引,不同租户就不能使用相同编号,业务规则会被错误扩大为全平台唯一。
正确约束应同时包含租户字段和业务字段:
CREATE DATABASE IF NOT EXISTS saas_demo
CHARACTER SET utf8mb4
COLLATE utf8mb4_unicode_ci;
USE saas_demo;
DROP TABLE IF EXISTS tenant_order;
CREATE TABLE tenant_order (
id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT,
tenant_id BIGINT UNSIGNED NOT NULL,
order_no VARCHAR(64) NOT NULL,
status VARCHAR(20) NOT NULL,
created_at DATETIME NOT NULL,
PRIMARY KEY (id),
UNIQUE KEY uk_tenant_order_no (tenant_id, order_no),
KEY idx_tenant_status_created (tenant_id, status, created_at)
) ENGINE = InnoDB;uk_tenant_order_no 表示:同一 tenant_id 下的 order_no 不可重复,但不同租户可以安全复用同一订单号。索引名称也应体现字段含义,便于排查约束冲突。
执行下面的边界验证:
USE saas_demo;
INSERT INTO tenant_order
(tenant_id, order_no, status, created_at)
VALUES
(1001, 'ORDER-001', 'PAID', '2026-08-03 10:00:00'),
(1002, 'ORDER-001', 'PAID', '2026-08-03 10:05:00');
INSERT INTO tenant_order
(tenant_id, order_no, status, created_at)
VALUES
(1001, 'ORDER-001', 'PENDING', '2026-08-03 10:10:00');预期结果:
前两条记录插入成功。
第三条记录插入失败,并返回 Duplicate entry,冲突索引为 uk_tenant_order_no。报错文本中的组合值可能因 MySQL 版本而不同,但必须确认冲突发生在同一租户的重复订单号,而不是不同租户之间。
按查询设计联合索引
联合索引应从高频查询反推,而不是把常用字段机械拼接。对于“查询某租户某状态、按时间范围筛选”的语句,索引 (tenant_id, status, created_at) 符合常见规则:等值条件在前,范围条件在后。
对应查询如下:
USE saas_demo;
EXPLAIN
SELECT id, order_no, status, created_at
FROM tenant_order
WHERE tenant_id = 1001
AND status = 'PAID'
AND created_at >= '2026-08-01 00:00:00'
AND created_at < '2026-09-01 00:00:00'
ORDER BY created_at;预期结果:
执行计划的 possible_keys 应包含 idx_tenant_status_created。
当数据量足够且统计信息正常时,key 应选择 idx_tenant_status_created,访问类型通常为 range。示例表仅有少量数据时,优化器可能选择全表扫描,因为扫描整表成本更低。此时应补充接近生产规模的测试数据后再次执行 EXPLAIN,不能据此直接判定索引无效。
联合索引遵循最左前缀原则。索引 (tenant_id, status, created_at) 可以支持只按 tenant_id 查询,也可以支持 tenant_id + status,但不能高效支持完全跳过 tenant_id 的全局状态查询。
控制索引数量与验证效果
唯一索引首先表达数据约束,普通联合索引首先服务查询路径。(tenant_id, order_no) 很适合按租户和订单号精确查询,但不能替代 (tenant_id, status, created_at) 这类列表查询索引。
不要为了“覆盖所有场景”创建大量相近索引。索引越多,新增和更新的维护成本越高,也会占用更多磁盘与缓冲池。应根据慢查询、执行计划和访问频率保留少量高价值索引。
新增业务表时,先判断业务唯一性是全平台级还是租户级,再列出高频 SQL 的等值过滤、范围过滤、排序和分页条件。最后用接近生产规模的数据执行 EXPLAIN 和耗时测试,形成“约束正确、查询可验证”的闭环。
Tips:查询中即使已经包含全局唯一主键,也建议保留
tenant_id条件。它不仅用于索引过滤,也承担数据权限边界的表达。
本课总结
- 租户内唯一的业务字段应使用
(tenant_id, business_key)联合唯一约束 - 联合索引应按真实查询条件组织,通常先放等值条件,再放范围条件
- 索引是否有效必须通过
EXPLAIN和接近真实规模的数据验证
下一课预告
下一课将继续完善租户数据模型,讨论外键关系、跨表租户一致性以及如何阻止不同租户的数据被错误关联。