Ein Enum ist ein Datentyp, dessen Werte aus einer festen Liste stammen, die du deklarierst: CREATE TYPE name AS ENUM ('a', 'b', 'c'). Eine Spalte dieses Typs akzeptiert nur diese Labels und sortiert sie in der deklarierten Reihenfolge, nicht alphabetisch.
Die Zeilen kommen in der Reihenfolge new, paid, shipped, delivered zurück. Ein Label, das nicht in der Liste steht, etwa 'lost', scheitert beim Insert mit invalid input value for enum order_status: "lost".
Nach Position vergleichen und filtern
Weil die Werte geordnet sind, vergleichen <, > und BETWEEN die Positionen in der Liste. „Bezahlt oder ein späterer Status“ wird so zu einer einzigen Bedingung:
Die Bestellungen 1, 3 und 4 passen. Auch min(status) und max(status) folgen der deklarierten Reihenfolge.
Die Werte eines Enums auflisten
enum_range(NULL::type) liefert jedes Label als Array, und unnest macht Zeilen daraus:
enum_first(NULL::mood) und enum_last(NULL::mood) liefern das erste und das letzte Label. In psql zeigt \dT+ mood den Typ mit seinen Werten.
Einen Wert hinzufügen oder umbenennen
ALTER TYPE ... ADD VALUE hängt ein Label an oder platziert es mit BEFORE oder AFTER. RENAME VALUE ändert ein Label, und jede Zeile, die es nutzt, zieht mit, weil Zeilen einen Verweis auf das Label speichern und nicht seinen Text.
Die Liste ist jetzt pending, paid, packed, shipped, delivered. Mit IF NOT EXISTS passiert nichts, wenn das Label schon existiert.
PostgreSQL kann keinen Wert entfernen und bestehende nicht umsortieren. Leg stattdessen einen neuen Typ an, wandle die Spalte in diesen um und lösche den alten:
CREATE TYPE order_status_new AS ENUM ('pending', 'paid', 'shipped');
UPDATE orders SET status = 'shipped' WHERE status = 'delivered';
ALTER TABLE orders
ALTER COLUMN status DROP DEFAULT,
ALTER COLUMN status TYPE order_status_new USING status::text::order_status_new;
DROP TYPE order_status;
ALTER TYPE order_status_new RENAME TO order_status;
Der Default wird zuerst entfernt, weil er als altes Enum typisiert ist. Setz ihn danach wieder.
Enum vs CHECK Constraint
Eine text Spalte mit einem CHECK Constraint schützt genauso, und ihre Liste lässt sich mit einem einfachen ALTER TABLE ändern:
Hier ist die Sortierung alphabetisch: erst new, dann paid.
| Enum | text + CHECK | |
|---|---|---|
| Sortierreihenfolge | Deklarierte Reihenfolge | Alphabetisch |
| Speicher | 4 Bytes | Länge des Texts |
| Wert entfernen | Neuer Typ und Umwandlung der Spalte | Constraint ersetzen |
| In mehreren Tabellen nutzen | Ein Typ | Constraint wiederholen |
Nimm ein Enum für eine kurze, stabile Liste, deren Reihenfolge etwas bedeutet, etwa Status oder Größen. Nimm CHECK oder eine Lookup-Tabelle mit Foreign Key, wenn sich die Liste oft ändert oder Werte entfernt werden. Das Kapitel zu Enums im Handbuch behandelt die restlichen Details.
Häufig gestellte Fragen
Wie lösche ich einen Wert aus einem PostgreSQL Enum?
Es gibt kein ALTER TYPE ... DROP VALUE. Leg ein neues Enum ohne den Wert an, aktualisiere die Zeilen, die ihn nutzen, wandle die Spalte mit ALTER TABLE ... ALTER COLUMN ... TYPE new_type USING col::text::new_type um und lösche dann den alten Typ.
Wie viel Platz braucht ein Enum-Wert?
4 Bytes pro Wert auf der Platte, egal wie lang sein Label ist. Labels unterscheiden Groß- und Kleinschreibung und dürfen bis zu 63 Bytes lang sein.
Kann ich ALTER TYPE ADD VALUE in einer Transaktion verwenden?
Ja, seit PostgreSQL 12. Der neue Wert ist aber erst nutzbar, wenn diese Transaktion committet ist.
Wie vergleiche ich eine Enum-Spalte mit Text?
Ein String-Literal wird automatisch in das Enum umgewandelt, WHERE status = 'paid' funktioniert also. Eine Text-Spalte oder ein Parameter braucht einen Cast, status = $1::order_status, oder du vergleichst als Text mit status::text = $1.