Un enum è un tipo di dato i cui valori vengono da una lista fissa che dichiari tu: CREATE TYPE name AS ENUM ('a', 'b', 'c'). Una colonna di quel tipo accetta solo quelle etichette e le ordina nell'ordine dichiarato, non in ordine alfabetico.
Le righe tornano nell'ordine new, paid, shipped, delivered. Inserire un'etichetta che non è nella lista, come 'lost', fallisce con invalid input value for enum order_status: "lost".
Confrontare e filtrare per posizione
Dato che i valori sono ordinati, <, > e BETWEEN confrontano le posizioni nella lista. "Pagato o qualsiasi stato successivo" diventa una sola condizione:
Corrispondono gli ordini 1, 3 e 4. Anche min(status) e max(status) seguono l'ordine dichiarato.
Elencare i valori di un enum
enum_range(NULL::type) restituisce tutte le etichette come array, e unnest le trasforma in righe:
enum_first(NULL::mood) ed enum_last(NULL::mood) restituiscono la prima e l'ultima etichetta. In psql, \dT+ mood mostra il tipo con i suoi valori.
Aggiungere o rinominare un valore
ALTER TYPE ... ADD VALUE aggiunge un'etichetta in fondo, oppure la posiziona con BEFORE o AFTER. RENAME VALUE cambia un'etichetta, e ogni riga che la usa si aggiorna di conseguenza, perché le righe salvano un riferimento all'etichetta e non il suo testo.
Ora la lista è pending, paid, packed, shipped, delivered. Con IF NOT EXISTS, aggiungere un'etichetta che c'è già non fa niente.
PostgreSQL non può rimuovere un valore né riordinare quelli esistenti. Invece crea un nuovo tipo, converti la colonna verso di esso ed elimina quello vecchio:
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;
Il default viene tolto prima perché ha il tipo del vecchio enum. Impostalo di nuovo alla fine.
Enum o vincolo CHECK
Una colonna text con un vincolo CHECK dà la stessa protezione, e la sua lista si può cambiare con un semplice ALTER TABLE:
Qui l'ordinamento è alfabetico: new, poi paid.
| Enum | text + CHECK | |
|---|---|---|
| Ordinamento | Ordine dichiarato | Alfabetico |
| Spazio occupato | 4 byte | Lunghezza del testo |
| Rimuovere un valore | Nuovo tipo e conversione della colonna | Sostituire il vincolo |
| Riuso in più tabelle | Un solo tipo | Ripetere il vincolo |
Scegli un enum per una lista corta e stabile il cui ordine ha un significato, come stati o taglie. Scegli CHECK, oppure una tabella di riferimento con una chiave esterna, quando la lista cambia spesso o i valori vengono rimossi. Il capitolo sugli enum del manuale copre gli altri dettagli.
Domande frequenti
Come elimino un valore da un enum in PostgreSQL?
Non esiste ALTER TYPE ... DROP VALUE. Crea un nuovo enum senza quel valore, converti la colonna con ALTER TABLE ... ALTER COLUMN ... TYPE new_type USING col::text::new_type dopo aver aggiornato le righe che lo usano, poi elimina il vecchio tipo.
Quanto spazio occupa un valore enum?
4 byte per valore su disco, qualunque sia la lunghezza dell'etichetta. Le etichette distinguono maiuscole e minuscole e possono essere lunghe fino a 63 byte.
Posso usare ALTER TYPE ADD VALUE dentro una transazione?
Sì, da PostgreSQL 12. Il nuovo valore però non si può usare finché quella transazione non ha fatto commit.
Come confronto una colonna enum con un testo?
Un letterale stringa viene convertito automaticamente nell'enum, quindi WHERE status = 'paid' funziona. Una colonna o un parametro di tipo testo ha bisogno di un cast, status = $1::order_status, oppure confronta come testo con status::text = $1.