↑↓ 选择 ↵ 打开 ⌫ 改范围 完整检索页

pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。

百科 / 数据类型 / 类型类别

Enumerated types

枚举(enum)类型是由一个静态的有序值集合构成的数据类型。它们等效于很多编程语言所支持的 enum 类型。枚举类型的一个示例可以是一周中的各天,或者一个数据的状态值集合。

当前查看 PostgreSQL 18.6。

PG10–20 核心源码清单。类型转换与操作符类列出源码显式声明的关系;缺少记录不能排除通过其他机制进行转换或使用索引。

定义

枚举(enum)类型是由一个静态的有序值集合构成的数据类型。它们等效于很多编程语言所支持的 enum 类型。枚举类型的一个示例可以是一周中的各天,或者一个数据的状态值集合。

Enumerated types
对象边界
用户定义类型族;不代表用户对象的有限清单

中文手册

阅读完整手册章节

阅读来源定义

8.7. 枚举类型

枚举(enum)类型是由一个静态的有序值集合构成的数据类型。它们等效于很多编程语言所支持的enum类型。枚举类型的一个示例可以是一周中的各天,或者一个数据的状态值集合。

可以使用CREATE TYPE命令创建枚举类型,例如:

CREATE TYPE mood AS ENUM ('sad', 'ok', 'happy');

创建之后,该 enum 类型就可以像任何其他类型一样在表定义和函数定义中使用:

CREATE TYPE mood AS ENUM ('sad', 'ok', 'happy');
CREATE TABLE person (
    name text,
    current_mood mood
);
INSERT INTO person VALUES ('Moe', 'happy');
SELECT * FROM person WHERE current_mood = 'happy';
 name | current_mood
------+--------------
 Moe  | happy
(1 row)

enum 类型中各值的顺序,就是创建该类型时列出的顺序。枚举支持所有标准比较操作符以及相关聚合函数。例如:

INSERT INTO person VALUES ('Larry', 'sad');
INSERT INTO person VALUES ('Curly', 'ok');
SELECT * FROM person WHERE current_mood > 'sad';
 name  | current_mood
-------+--------------
 Moe   | happy
 Curly | ok
(2 rows)

SELECT * FROM person WHERE current_mood > 'sad' ORDER BY current_mood;
 name  | current_mood
-------+--------------
 Curly | ok
 Moe   | happy
(2 rows)

SELECT name
FROM person
WHERE current_mood = (SELECT MIN(current_mood) FROM person);
 name
-------
 Larry
(1 row)

每一种枚举数据类型都是独立的并且不能和其他枚举类型相比较。看这样一个示例:

CREATE TYPE happiness AS ENUM ('happy', 'very happy', 'ecstatic');
CREATE TABLE holidays (
    num_weeks integer,
    happiness happiness
);
INSERT INTO holidays(num_weeks,happiness) VALUES (4, 'happy');
INSERT INTO holidays(num_weeks,happiness) VALUES (6, 'very happy');
INSERT INTO holidays(num_weeks,happiness) VALUES (8, 'ecstatic');
INSERT INTO holidays(num_weeks,happiness) VALUES (2, 'sad');
ERROR:  invalid input value for enum happiness: "sad"
SELECT person.name, holidays.num_weeks FROM person, holidays
  WHERE person.current_mood = holidays.happiness;
ERROR:  operator does not exist: mood = happiness

如果你确实需要做这类事情,可以编写自定义操作符,或者在查询中添加显式类型转换:

SELECT person.name, holidays.num_weeks FROM person, holidays
  WHERE person.current_mood::text = holidays.happiness::text;
 name | num_weeks
------+-----------
 Moe  |         4
(1 row)

枚举标签是大小写敏感的,因此'happy'与'HAPPY'是不同的。标签中的空白也是有意义的。

尽管枚举类型的主要目的是用于值的静态集合,但也有方法在现有枚举类型中增加新值和重命名值(见ALTER TYPE)。不能从枚举类型中去除现有的值,也不能更改这些值的排序顺序;除非删除并重建枚举类型,否则无法这样做。

枚举值在磁盘上占四字节。枚举值的文本标签长度受编译 PostgreSQL 时设置的 NAMEDATALEN 限制;在标准构建中,最多为 63 字节。

从内部枚举值到文本标签的转换关系被保存在系统目录pg_enum中。直接查询该目录可能会有所帮助。

版本比较

PostgreSQL 17.11 → 18.6。属性比较不包含构建标识和说明正文;原始目录字段与源描述保留原文。

这两个样本的系统目录和结构化属性没有变化。

这些构建的文档也有差异,请查看对应版本的手册定义。

文档与源码

构建
18.6 · https://ftp.postgresql.org/pub/source/v18.6/postgresql-18.6.tar.bz2
指纹
555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f

全部数据类型 · 下载此版本 JSON · 最早收录的样本不代表该类型的实际引入版本。