Перечислимые типы

Перечислимые (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" -- ОШИБКА: неверное значение для перечисления happiness: "sad" SELECT person.name, holidays.num_weeks FROM person, holidays WHERE person.current_mood = holidays.happiness; ERROR: operator does not exist: mood = happiness -- ОШИБКА: оператор не существует: 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). А вот удалить или изменить порядок сортировки существующих значений в перечислении нельзя; для этого придется удалить и воссоздать это перечисление.

Значение перечислимого типа занимает на диске четыре байта. Длина текстовой метки перечислимого значения ограничена настройкой NAMEDATALEN, скомпилированной в QHB; в стандартных сборках длина ограничена 63 байтами.

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