8.7. Перечисляемые типы#

8.7. Перечисляемые типы

8.7. Перечисляемые типы #

Перечисляемые (enum) типы - это типы данных, которые состоят из статического упорядоченного набора значений. Они эквивалентны типам enum, поддерживаемым во многих языках программирования. Примером enum-типа может быть дни недели или набор значений статуса для некоторых данных.

8.7.1. Объявление перечисляемых типов #

Типы перечислений создаются с помощью команды 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 соответствует порядку, в котором значения были перечислены при создании типа. Все стандартные операторы сравнения и связанные агрегатные функции поддерживаются для 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 метки чувствительны к регистру, поэтому 'happy' не равно 'HAPPY'. Пробелы в метках также имеют значение.

Хотя перечисляемые типы в основном предназначены для статических наборов значений, существует поддержка добавления новых значений к существующему перечисляемому типу и переименования значений (см. ALTER TYPE). Существующие значения не могут быть удалены из перечисляемого типа, и также нельзя изменить порядок сортировки таких значений, кроме как путем удаления и повторного создания перечисляемого типа.

Значение перечисления занимает четыре байта на диске. Длина текстовой метки значения перечисления ограничена настройкой NAMEDATALEN, скомпилированной в Tantor SE-1C; в стандартной сборке это означает, что максимум 63 байта.

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