列舉(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"
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)
列舉標籤是區分大小寫的,所以 'happy' 和 'HAPPY' 是不同的。標籤中的空格也很重要。
雖然列舉型別主要用於靜態值集合,但它也支援向現有列舉型別新增新值,以及重新命名值(參見 ALTER TYPE)。現有值不能從列舉型別中刪除,其排序順序也不能改變,除非刪除並重新建立列舉型別。
列舉值在磁碟上佔用四個位元組。列舉值文字標籤的長度受編譯到 PostgreSQL 中的 NAMEDATALEN 設定的限制;在標準構建中,這意味著最多 63 位元組。
從內部列舉值到文字標籤的轉換儲存在系統目錄 pg_enum 中。直接查詢此目錄可能很有用。
如果你在文件中看到任何不正確、與你對特定功能的使用經驗不符或需要進一步澄清的內容,請使用 此表單 報告文件問題。