Redrock Postgres 搜索 英文
版本: 9.3 / 9.4 / 9.5 / 9.6 / 10 / 11 / 12 / 13 / 14 / 15 / 16 / 17

8.7。枚举类型 #

8.7.1。枚举类型声明
8.7.2。排序
8.7.3。类型安全
8.7.4。实现细节

枚举 (enum) 类型是包含一组静态有序值的数据类型。它们等同于多种编程语言中支持的 enum 类型。枚举类型的一个示例可能是星期几,或者是针对某个数据片段的一组状态值。

8.7.1. 枚举类型的声明 #

枚举类型是使用 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)

8.7.2. 排序 #

枚举类型中值排序是创建类型时列出值所采用的顺序。枚举支持所有标准比较运算符和相关的聚合函数。例如

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)

8.7.3. 类型安全性 #

每个枚举数据类型都是独立的,不可与其他枚举类型进行比较。请参阅此示例

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)

8.7.4. 实施详细信息 #

枚举标签区分大小写,因此 'happy''HAPPY' 不同。标签中的空格也很重要。

虽然枚举类型主要用于静态值集,但支持向现有枚举类型添加新值以及重命名值(请参阅 ALTER TYPE)。不能从枚举类型中移除现有值,也不能更改此类值的排序顺序,除非删除并重新创建枚举类型。

枚举值在磁盘上占用 4 个字节。枚举值的文本标签的长度受编译到 PostgreSQL 中的 NAMEDATALEN 设置限制;对于标准构建,这意味着最多 63 个字节。

从内部枚举值到文本标签的转换保存在系统目录 pg_enum 中。直接查询此目录可能很有用。