全部產品
Search
文件中心

PolarDB:枚舉類型

更新時間:Jul 06, 2024

本文介紹了枚舉類型的定義及相關文法。

枚舉(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)。不能從枚舉類型中去除現有的值,也不能更改這些值的排序次序,如果要那樣做可以刪除並且重建枚舉類型。

一個枚舉值在磁碟上佔據 4 個位元組。一個枚舉值的文字標籤的長度受限於NAMEDATALEN設定,該設定被編譯在本資料庫中,在標準編譯下它表示最多 63 位元組。

從內部枚舉值到文字標籤的翻譯被儲存在系統目錄pg_enum中。可以直接查詢該目錄。