PostgreSQL / 系统课时

枚举、域与复合类型

枚举、域与复合类型

本课解决自定义类型该不该进入数据库的问题:通过订单模型比较 enum、domain 与复合类型的约束能力、复用价值和演进限制,形成可执行的建模判断标准。

学习目标

  • 区分枚举、域和复合类型各自约束的对象
  • 能用自定义类型表达稳定的状态、值域和字段组合
  • 识别类型演进对表、SQL 和应用发布的影响

三类类型的建模边界

枚举用于表达封闭且稳定的离散集合,例如订单状态。数据库会拒绝集合外的值,并按枚举定义顺序比较,但删除值、重排顺序或大规模改名都不够灵活。

域是在现有基础类型上叠加默认值、非空或检查约束。它适合复用“正金额”“标准邮箱”“三位币种代码”等单值规则,同时仍保留基础类型的大部分操作能力。

复合类型把多个字段组合成一个值,例如“金额加币种”或“经纬度”。它能减少重复结构,但查询、索引、序列化和模式演进更复杂,不应仅为了少写几列而使用。

构建一个可运行的订单模型

下面示例用枚举限制订单状态,用域保证金额大于零,再用复合类型保存金额与币种。执行前先删除同名对象,便于重复练习。

sql
DROP TABLE IF EXISTS typed_orders;
DROP TYPE IF EXISTS money_value;
DROP DOMAIN IF EXISTS positive_amount;
DROP TYPE IF EXISTS order_state;

CREATE TYPE order_state AS ENUM (
    'pending',
    'paid',
    'cancelled'
);

CREATE DOMAIN positive_amount AS numeric(12, 2)
    CHECK (VALUE > 0);

CREATE TYPE money_value AS (
    amount positive_amount,
    currency char(3)
);

CREATE TABLE typed_orders (
    id bigint GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
    state order_state NOT NULL DEFAULT 'pending',
    total money_value NOT NULL
);

INSERT INTO typed_orders (state, total)
VALUES (
    'paid',
    ROW(99.90, 'CNY')::money_value
);

SELECT
    id,
    state,
    (total).amount AS amount,
    trim((total).currency) AS currency
FROM typed_orders;

预期结果:

text
 id | state | amount | currency
----+-------+--------+----------
  1 | paid  |  99.90 | CNY
(1 row)

如果插入负金额,域约束会在任何使用该域的列或复合字段上生效,而不是只保护当前表。

sql
INSERT INTO typed_orders (total)
VALUES (ROW(-1.00, 'CNY')::money_value);

预期结果:

text
ERROR:  value for domain positive_amount violates check constraint "positive_amount_check"

什么时候值得使用

稳定状态集合适合枚举,但“后台可配置状态”“频繁新增状态”或“需要停用而不是删除的状态”更适合字典表。字典表虽然多一次连接,却能保存显示名、排序、启停时间和附加属性。

域适合跨表重复出现且规则一致的单值约束。如果不同表对同一字段允许范围不同,直接写列级 CHECK 更清楚,避免域变成过度耦合的全局规则。

复合类型适合字段必须作为整体传递、函数参数或返回值复用的场景。若字段经常独立过滤、排序或建立索引,拆成普通列通常更容易优化和维护。

演进限制与发布顺序

枚举可以追加新值,也可以重命名值,但删除或重排通常需要新建类型、转换列并替换旧类型。应用在引用新枚举值前,应先完成数据库变更并提交,再发布使用该值的代码。

修改域约束会影响所有使用位置。新增约束前应先清洗存量数据,否则变更可能失败;放宽约束通常风险较低,但仍需验证依赖它的应用逻辑。

复合类型增加或删除属性会改变整行结构。依赖字段位置、驱动映射或序列化格式的代码可能同时受影响,因此应优先按字段名访问,并把类型变更纳入兼容性测试。

本课总结

  • 枚举约束稳定集合,域复用单值规则,复合类型封装成组字段
  • 变化频繁的状态优先用字典表,独立查询频繁的字段优先保留普通列
  • 自定义类型会扩大数据库变更影响面,使用前必须评估发布与迁移成本

下一课预告

下一课将继续讨论约束、外键与延迟检查,学习如何在复杂写入流程中维护跨表完整性。

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

目录与阅读设置

阅读设置

17

记录一个想法

枚举、域与复合类型

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

登录哪都通