8.7. Перечисления

8.7.1. Объявление перечислений

Типы 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)

8.7.2. Порядок значений

Порядок значений в типе 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)

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. Подробности реализации

Тип enum занимает четыре байта на диске. Длина значения типа enum (текстовой метки) ограничена настройкой NAMEDATALEN, вкомпилированной в PostgreSQL; и при стандартной сборке, составляет по крайней мере 63 байта.

Значения перечислений зависят от регистра букв, так что 'happy' не тоже самое, что 'HAPPY'. Пробелы в значениях также учитываются.

Преобразования из внутренних значений перечисления в текстовые метки осуществляется в системном каталоге pg_enum. Может оказаться полезным опросить этот каталог напрямую.