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 BE; в стандартной сборке это означает, что максимум 63 байта.
Все переводы из внутренних значений перечислений в текстовые метки хранятся в системном каталоге pg_enum
. Прямой запрос этого каталога может быть полезен.