支援的版本: 目前版本 (17) / 16 / 15 / 14 / 13
開發版本: devel
不支援的版本: 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3

8.7. 列舉類型 #

列舉 (enum) 類型是由一組靜態、已排序的值所組成的資料類型。它們等同於許多程式語言中支援的 enum 類型。列舉類型的例子可能是星期幾,或者一組資料的狀態值。

8.7.1. 列舉類型的宣告 #

列舉類型是使用 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)

8.7.2. 排序 #

列舉類型中值的排序是在建立類型時列出這些值的順序。 所有標準比較運算子和相關的聚合函式都支援列舉。 例如

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. 實作細節 #

列舉標籤區分大小寫,因此 'happy''HAPPY' 不同。 標籤中的空格也很重要。

雖然列舉類型主要用於靜態值集,但支援將新值新增到現有的列舉類型,以及重新命名值(請參閱 ALTER TYPE)。 無法從列舉類型中移除現有值,也無法更改這些值的排序,除非刪除並重新建立列舉類型。

列舉值在磁碟上佔用四個位元組。 列舉值的文字標籤的長度受到編譯到 PostgreSQL 中的 NAMEDATALEN 設定的限制;在標準版本中,這表示最多 63 個位元組。

從內部列舉值到文字標籤的轉換保存在系統目錄 pg_enum 中。 直接查詢此目錄可能很有用。

提交更正

如果您在文件中發現任何不正確、與您對特定功能的體驗不符或需要進一步澄清的地方,請使用 此表格 回報文件問題。