Enum הוא טיפוס נתונים שהערכים שלו מגיעים מרשימה קבועה שאתם מגדירים: CREATE TYPE name AS ENUM ('a', 'b', 'c'). עמודה מהטיפוס הזה מקבלת רק את התוויות האלה וממיינת אותן לפי סדר ההגדרה, לא לפי האלף בית.
השורות חוזרות בסדר new, paid, shipped, delivered. הכנסה של תווית שלא ברשימה, כמו 'lost', נכשלת עם invalid input value for enum order_status: "lost".
השוואה וסינון לפי מיקום
מכיוון שהערכים מסודרים, <, > ו-BETWEEN משווים מיקומים ברשימה. "שולם או כל סטטוס מאוחר יותר" הופך לתנאי אחד:
הזמנות 1, 3 ו-4 מתאימות. גם min(status) ו-max(status) הולכים לפי סדר ההגדרה.
להציג את הערכים של enum
enum_range(NULL::type) מחזיר את כל התוויות כמערך, ו-unnest הופך אותו לשורות:
enum_first(NULL::mood) ו-enum_last(NULL::mood) מחזירים את התווית הראשונה ואת האחרונה. ב-psql, \dT+ mood מציג את הטיפוס עם הערכים שלו.
להוסיף ערך או לשנות את שמו
ALTER TYPE ... ADD VALUE מוסיף תווית בסוף, או ממקם אותה עם BEFORE או AFTER. RENAME VALUE משנה תווית, וכל שורה שמשתמשת בה מתעדכנת, כי שורות שומרות הפניה לתווית ולא את הטקסט שלה.
הרשימה עכשיו היא pending, paid, packed, shipped, delivered. IF NOT EXISTS הופך הוספה של תווית שכבר קיימת לפעולה שלא עושה כלום.
PostgreSQL לא יכול להסיר ערך או לשנות את הסדר של ערכים קיימים. במקום זה, צרו טיפוס חדש, המירו אליו את העמודה ומחקו את הישן:
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;
ברירת המחדל נמחקת קודם כי הטיפוס שלה הוא ה-enum הישן. הגדירו אותה שוב אחר כך.
Enum מול אילוץ CHECK
עמודת text עם אילוץ CHECK נותנת את אותה הגנה, ואפשר לשנות את הרשימה שלה עם ALTER TABLE פשוט:
כאן המיון הוא לפי האלף בית: new, ואחריו paid.
| Enum | text + CHECK | |
|---|---|---|
| סדר המיון | סדר ההגדרה | אלפביתי |
| אחסון | 4 בתים | אורך הטקסט |
| הסרת ערך | טיפוס חדש והמרת עמודה | החלפת האילוץ |
| שימוש חוזר בכמה טבלאות | טיפוס אחד | חזרה על האילוץ |
בחרו ב-enum לרשימה קצרה ויציבה שלסדר שלה יש משמעות, כמו סטטוסים או מידות. בחרו ב-CHECK, או בטבלת חיפוש עם מפתח זר, כשהרשימה משתנה לעיתים קרובות או כשמסירים ממנה ערכים. פרק ה-enum במדריך מכסה את שאר הפרטים.
שאלות נפוצות
איך מוחקים ערך מ-enum ב-PostgreSQL?
אין ALTER TYPE ... DROP VALUE. צרו enum חדש בלי הערך, המירו את העמודה עם ALTER TABLE ... ALTER COLUMN ... TYPE new_type USING col::text::new_type אחרי שעדכנתם את השורות שמשתמשות בו, ואז מחקו את הטיפוס הישן.
כמה מקום תופס ערך enum?
4 בתים לערך בדיסק, בלי קשר לאורך התווית. התוויות רגישות לאותיות גדולות וקטנות ויכולות להיות באורך של עד 63 בתים.
אפשר להשתמש ב-ALTER TYPE ADD VALUE בתוך טרנזקציה?
כן, מאז PostgreSQL 12. אי אפשר להשתמש בערך החדש עד שהטרנזקציה הזו ביצעה commit.
איך משווים עמודת enum לטקסט?
ליטרל של מחרוזת מומר ל-enum אוטומטית, כך ש-WHERE status = 'paid' עובד. עמודת טקסט או פרמטר צריכים המרה, status = $1::order_status, או השוואה כטקסט עם status::text = $1.