Menu

טיפוסי Enum ב-PostgreSQL: ‏CREATE TYPE AS ENUM

טיפוס enum הוא רשימה קבועה ומסודרת של ערכים מותרים, שנוצרת עם CREATE TYPE ... AS ENUM. כולל הוספה ושינוי שם של ערכים, הצגתם, מיון, ומתי אילוץ CHECK עדיף.

בדף הזה יש עורכים שאפשר להריץ. לערוך, להריץ ולראות את הפלט מיד.

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.

Enumtext + 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.

איור של שפות התכנות ב-Coddy

ללמוד תכנות עם Coddy

להתחיל