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.