Enum, değerleri senin tanımladığın sabit bir listeden gelen bir veri tipidir: CREATE TYPE name AS ENUM ('a', 'b', 'c'). Bu tipteki bir sütun yalnızca o etiketleri kabul eder ve onları alfabetik olarak değil, tanımlandıkları sırayla sıralar.
Satırlar new, paid, shipped, delivered sırasıyla gelir. Listede olmayan 'lost' gibi bir etiket eklemek invalid input value for enum order_status: "lost" hatasıyla başarısız olur.
Konuma göre karşılaştırmak ve filtrelemek
Değerler sıralı olduğu için <, > ve BETWEEN listedeki konumları karşılaştırır. "Ödenmiş ya da daha sonraki herhangi bir durum" tek bir koşul olur:
1, 3 ve 4 numaralı siparişler eşleşir. min(status) ve max(status) da tanımlanan sırayı izler.
Bir enum'un değerlerini listelemek
enum_range(NULL::type) her etiketi bir dizi olarak döndürür, unnest de onu satırlara çevirir:
enum_first(NULL::mood) ve enum_last(NULL::mood) ilk ve son etiketi döndürür. psql'de \dT+ mood tipi değerleriyle birlikte gösterir.
Değer eklemek ya da adını değiştirmek
ALTER TYPE ... ADD VALUE bir etiketi sona ekler ya da BEFORE veya AFTER ile yerini belirler. RENAME VALUE bir etiketi değiştirir ve onu kullanan her satır da değişir, çünkü satırlar etiketin metnini değil, ona bir referansı saklar.
Liste artık pending, paid, packed, shipped, delivered. IF NOT EXISTS, zaten var olan bir etiketi eklemeyi etkisiz bir işlem yapar.
PostgreSQL bir değeri kaldıramaz ya da var olan değerlerin sırasını değiştiremez. Bunun yerine yeni bir tip oluştur, sütunu ona dönüştür ve eskisini sil:
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;
Varsayılan değer önce kaldırılır, çünkü tipi eski enum'dur. Sonrasında onu yeniden ayarla.
Enum ve CHECK kısıtı
CHECK kısıtı olan bir text sütunu aynı korumayı sağlar ve listesi düz bir ALTER TABLE ile değiştirilebilir:
Burada sıralama alfabetiktir: önce new, sonra paid.
| Enum | text + CHECK | |
|---|---|---|
| Sıralama | Tanımlanan sıra | Alfabetik |
| Depolama | 4 bayt | Metnin uzunluğu |
| Değer kaldırmak | Yeni tip ve sütun dönüşümü | Kısıtı değiştirmek |
| Birden çok tabloda kullanmak | Tek tip | Kısıtı tekrarlamak |
Durumlar ya da bedenler gibi sırasının bir anlamı olan kısa ve sabit bir liste için enum seç. Liste sık değişiyorsa ya da değerler kaldırılıyorsa CHECK ya da yabancı anahtarlı bir başvuru tablosu seç. Kalan ayrıntılar kılavuzun enum bölümünde anlatılıyor.
Sıkça Sorulan Sorular
PostgreSQL enum'dan bir değer nasıl silinir?
ALTER TYPE ... DROP VALUE diye bir komut yok. O değer olmadan yeni bir enum oluştur, değeri kullanan satırları güncelledikten sonra sütunu ALTER TABLE ... ALTER COLUMN ... TYPE new_type USING col::text::new_type ile dönüştür, ardından eski tipi sil.
Bir enum değeri ne kadar yer kaplar?
Etiketinin uzunluğu ne olursa olsun diskte değer başına 4 bayt. Etiketler büyük/küçük harfe duyarlıdır ve en fazla 63 bayt uzunluğunda olabilir.
ALTER TYPE ADD VALUE bir transaction içinde kullanılabilir mi?
Evet, PostgreSQL 12'den beri. Yeni değer, o transaction commit edilene kadar kullanılamaz.
Bir enum sütununu metinle nasıl karşılaştırırım?
Bir metin sabiti otomatik olarak enum'a çevrilir, bu yüzden WHERE status = 'paid' çalışır. Bir text sütunu ya da parametre ise cast ister: status = $1::order_status. Ya da metin olarak karşılaştır: status::text = $1.