枚举(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 中。直接查询此目录可能很有用。
如果你在文档中看到任何不正确、与你对特定功能的使用经验不符或需要进一步澄清的内容,请使用 此表单 报告文档问题。