用于字段的数据类型

用在字段（列）上的数据类型，核心原则是必须是在磁盘上有明确存储表示的类型。因此，PostgreSQL 的伪类型（Pseudo-Types），如 anyelement、trigger、internal 等，绝对不可以用作字段类型，它们仅用于定义函数参数或返回值。

排除伪类型后，可用在字段上的数据类型及具体要求如下。

🔢 数值类型#

numeric 的精度与标度：p 是总有效位数，s 是小数点后的位数。NUMERIC(8, 2) 表示总共 8 位数字，其中小数点后 2 位，因此整数部分最多 6 位。如果存入的值标度大于声明值，系统会自动四舍五入到声明的小数位。

📝 字符类型#

🕒 日期与时间类型#

time、timestamp 和 interval 均支持可选的精度 p，用于控制秒的小数部分位数。

• p 的取值范围：0 到 6（默认使用微秒精度，即 p=6）。
• date：无精度参数，仅存储年月日。
• timestamptz：记录“时间点”的首选。它内部以 UTC 存储，显示时按会话时区转换，能正确处理跨时区数据。
• timestamp：不带时区，存储的是“墙上时钟”字面值，不随时区转换。
• interval：表示时间间隔，同样支持 p 来限制秒的小数位精度。

🚀 JSON 类型#

jsonb 字段的约束实践：可以在 jsonb 列上使用 CHECK 约束来强制某些键的存在或值的格式。对于高频查询的 jsonb 路径，需要创建表达式索引（如 CREATE INDEX ... ON tbl ((data->>'key'))）或对整个列创建 GIN 索引，否则查询将全表扫描。

📦 数组类型#

• 定义语法：在任意可用作字段的基础类型后加 []，如 integer[]、text[][]。可以创建内置类型、枚举、复合类型、范围或域的数组。
• 维度与长度：声明时的维度（如 [3][3]）和长度仅为文档说明，PostgreSQL 不会强制执行。但插入多维数组时，每个维度的长度必须严格匹配，否则报错。
• 元素类型一致性：一个数组字段中的所有元素必须属于同一种数据类型。

🎯 用户定义类型（字段层面的特殊要求）#

枚举（ENUM）

• 标签长度限制：每个枚举值（标签）的最大长度受编译参数 NAMEDATALEN 限制，标准安装下为 63 字节。
• 排序内在性：枚举值按声明顺序排序，这会影响 ORDER BY 和范围比较的结果。
• 适用边界：仅适用于封闭、稳定、极少变更的固定值集合（如订单状态）。频繁增删枚举值需要 ALTER TYPE，不适合动态性强的场景。

域（DOMAIN） 域是带约束的基础类型，用于将字段级别的通用约束（如 NOT NULL、CHECK）集中管理。

• 可附加的约束：NOT NULL / NULL、CHECK (expression) 以及 DEFAULT 默认值。
• 约束检查时机：域上的 NOT NULL 和 CHECK 约束在值被转换为域类型时进行检查。
• 字段可用性：域完全可以作为字段类型使用，它是将业务规则抽象到类型层面的有效手段（例如定义一个 email_address 域，自带格式校验 CHECK 约束）。

范围（RANGE） 与 复合（COMPOSITE） int4range、daterange、tstzrange 等范围类型，以及通过 CREATE TYPE ... AS (...) 定义的复合类型，都可以直接用作字段类型，无额外字段级限制。范围类型用于高效表达连续区间，复合类型用于将多个相关属性打包为一个逻辑单元。

💎 快速核对清单#