枚举(enum)类型是包含静态、有序值集的数据类型。它们等同于许多编程语言中支持的 enum
类型。枚举类型的一个例子可能是一周中的几天,或一组数据状态值。
枚举类型是使用 CREATE TYPE 命令创建的,例如
CREATE TYPE mood AS ENUM ('sad', 'ok', 'happy');
一旦创建,枚举类型就可以像任何其他类型一样用于表和函数定义中
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)
枚举类型中值的顺序是在创建类型时列出值的顺序。所有标准比较运算符和相关的聚合函数都支持枚举。例如
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
中。直接查询此目录可能很有用。
如果您发现文档中的任何内容不正确,与您使用特定功能的经验不符或需要进一步澄清,请使用 此表单 报告文档问题。