Enum adalah tipe data yang nilainya berasal dari daftar tetap yang kamu deklarasikan: CREATE TYPE name AS ENUM ('a', 'b', 'c'). Kolom dengan tipe itu hanya menerima label-label tersebut dan mengurutkannya sesuai urutan deklarasi, bukan menurut abjad.
Baris-barisnya kembali dengan urutan new, paid, shipped, delivered. Memasukkan label yang tidak ada di daftar, seperti 'lost', gagal dengan invalid input value for enum order_status: "lost".
Membandingkan dan memfilter berdasarkan posisi
Karena nilainya berurutan, <, >, dan BETWEEN membandingkan posisi di dalam daftar. "Sudah dibayar atau status apa pun setelahnya" menjadi satu kondisi:
Pesanan 1, 3, dan 4 cocok. min(status) dan max(status) juga mengikuti urutan deklarasi.
Melihat daftar nilai enum
enum_range(NULL::type) mengembalikan setiap label sebagai array, dan unnest mengubahnya menjadi baris:
enum_first(NULL::mood) dan enum_last(NULL::mood) mengembalikan label pertama dan terakhir. Di psql, \dT+ mood menampilkan tipe itu beserta nilainya.
Menambah atau mengganti nama nilai
ALTER TYPE ... ADD VALUE menambahkan label di akhir, atau menempatkannya dengan BEFORE atau AFTER. RENAME VALUE mengubah sebuah label, dan setiap baris yang memakainya ikut berubah, karena baris menyimpan referensi ke label itu, bukan teksnya.
Daftarnya sekarang pending, paid, packed, shipped, delivered. IF NOT EXISTS membuat penambahan label yang sudah ada tidak melakukan apa-apa.
PostgreSQL tidak bisa menghapus nilai atau mengubah urutan nilai yang sudah ada. Sebagai gantinya, buat tipe baru, konversi kolomnya ke tipe itu, lalu hapus tipe lama:
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;
Default-nya dihapus lebih dulu karena bertipe enum lama. Atur lagi setelahnya.
Enum vs constraint CHECK
Kolom text dengan constraint CHECK memberi perlindungan yang sama, dan daftarnya bisa diubah dengan ALTER TABLE biasa:
Di sini urutannya menurut abjad: new, lalu paid.
| Enum | text + CHECK | |
|---|---|---|
| Urutan | Urutan deklarasi | Menurut abjad |
| Storage | 4 byte | Panjang teksnya |
| Menghapus nilai | Tipe baru dan konversi kolom | Ganti constraint-nya |
| Dipakai di beberapa tabel | Satu tipe | Ulangi constraint-nya |
Pilih enum untuk daftar pendek dan stabil yang urutannya bermakna, seperti status atau ukuran. Pilih CHECK, atau tabel lookup dengan foreign key, saat daftarnya sering berubah atau nilainya bisa dihapus. Bab enum di manual membahas detail lainnya.
Pertanyaan yang sering diajukan
Bagaimana cara menghapus nilai dari enum PostgreSQL?
Tidak ada ALTER TYPE ... DROP VALUE. Buat enum baru tanpa nilai itu, perbarui baris yang memakainya, lalu konversi kolomnya dengan ALTER TABLE ... ALTER COLUMN ... TYPE new_type USING col::text::new_type, kemudian hapus tipe lamanya.
Berapa banyak ruang yang dipakai satu nilai enum?
4 byte per nilai di disk, berapa pun panjang label-nya. Label bersifat case sensitive dan panjangnya bisa sampai 63 byte.
Bisakah memakai ALTER TYPE ADD VALUE di dalam transaksi?
Bisa, sejak PostgreSQL 12. Nilai barunya belum bisa dipakai sampai transaksi itu di-commit.
Bagaimana cara membandingkan kolom enum dengan teks?
Literal string otomatis dikonversi ke enum, jadi WHERE status = 'paid' berjalan. Kolom teks atau parameter butuh cast, status = $1::order_status, atau bandingkan sebagai teks dengan status::text = $1.