Menu

المفتاح الأساسي في PostgreSQL: Identity وSERIAL وUUID

كيف تعرّف مفتاحًا أساسيًا في PostgreSQL وكيف تولّده: أعمدة identity، وSERIAL الأقدم، وUUID باستخدام gen_random_uuid(). إضافة إلى المفاتيح المركّبة وإعادة ضبط التسلسل.

تحتوي هذه الصفحة على محررات قابلة للتشغيل. حرّر، شغّل، وشاهد النتيجة فوراً.

المفتاح الأساسي هو العمود، أو مجموعة الأعمدة، التي تميّز كل صف. يجب أن تكون قيمه فريدة وغير NULL، ولا يكون للجدول إلا مفتاح أساسي واحد. في PostgreSQL تترك عادةً قاعدة البيانات تولّده بعمود identity: ‏id bigint GENERATED ALWAYS AS IDENTITY PRIMARY KEY.

المعرّفات هي 1 و2. وتعريف المفتاح ينشئ أيضًا فهرسًا فريدًا عليه اسمه users_pkey.

أعمدة identity: ‏ALWAYS مقابل BY DEFAULT

أعمدة identity هي الطريقة القياسية في SQL لترقيم الصفوف، ومتاحة منذ PostgreSQL 10. ولها صيغتان:

  • يرفض GENERATED ALWAYS AS IDENTITY أي قيمة صريحة في INSERT، إلا إذا تضمّن الإدراج OVERRIDING SYSTEM VALUE. وهذا هو الخيار الافتراضي الأكثر أمانًا.
  • يستخدم GENERATED BY DEFAULT AS IDENTITY القيمة المولّدة فقط عندما لا تقدّم قيمة بنفسك.

مع BY DEFAULT، يؤدي إدراج معرّفاتك الخاصة إلى تخلّف التسلسل، فيتعارض المعرّف المولّد التالي. بعد استيراد صفوف بمعرّفات صريحة، انقل التسلسل إلى ما بعد أعلاها باستخدام setval:

بدون سطر setval سيحصل الإدراج الأخير على المعرّف 1 ويفشل بخطأ مفتاح مكرر. ومعه يحصل الصف الجديد على 4.

SERIAL مقابل identity

serial ‏(4 بايت) وbigserial ‏(8 بايت) ليسا نوعين حقيقيين، بل اختصار ينشئ تسلسلًا ويجعل القيمة الافتراضية للعمود nextval() منه:

العمود integer عادي بقيمة افتراضية nextval('legacy_id_seq'::regclass). لا شيء يمنع الإدراج من كتابة معرّف خاص به، ويحتاج التسلسل إلى صلاحيات مستقلة. أعمدة identity تعالج الأمرين، ففضّلها في الجداول الجديدة. ما زال serial يعمل، وستصادفه في المخططات القديمة والدروس التعليمية.

استخدم bigint (أو bigserial) للجداول التي قد تكبر، فمفتاح integer ينفد بعد نحو 2.1 مليار قيمة.

مفاتيح أساسية من نوع UUID

تعيد gen_random_uuid() قيمة UUID عشوائية من الإصدار 4. وهي مدمجة منذ PostgreSQL 13، فلا حاجة إلى أي إضافة:

كل تشغيل يطبع معرّفات مختلفة، طول كل منها 36 حرفًا بصيغة النص. يخزّنها النوع uuid في 16 بايت، فاستخدمه بدل text. يضيف PostgreSQL 18 الدالة uuidv7() التي تولّد UUID مرتّبة زمنيًا تُدرج بترتيب الفهرس. أما على PostgreSQL 17 فولّدها في تطبيقك.

المفاتيح الأساسية المركّبة

يمكن للمفتاح أن يشمل عدة أعمدة، ويُكتب في سطر خاص به داخل CREATE TABLE. وهو المفتاح الطبيعي لجدول الربط، حيث يظهر كل زوج مرة واحدة فقط:

يُتخطّى الزوج المكرر (1, 10)، لذا يكون العدد 3. لإضافة مفتاح إلى جدول موجود استخدم ALTER TABLE t ADD PRIMARY KEY (col). تشرح صفحة ALTER TABLE بقية التغييرات. وتشير الجداول الأخرى إلى المفتاح عبر المفاتيح الأجنبية.

الأسئلة الشائعة

هل يوجد AUTO_INCREMENT في PostgreSQL؟

ليس بهذا الاسم. الطريقة القياسية هي عمود identity: ‏id bigint GENERATED ALWAYS AS IDENTITY PRIMARY KEY، المتاح منذ PostgreSQL 10. والنوعان الأقدم serial وbigserial يؤديان الغرض نفسه بتسلسل وقيمة افتراضية.

لماذا توجد فجوات في تسلسل المعرّفات في PostgreSQL؟

يمنح التسلسل قيمة حتى لو فشل الإدراج لاحقًا أو تراجعت معاملته، ولا يُعاد استخدام تلك القيمة أبدًا. الفجوات طبيعية ولا ضرر منها، فلا تعتمد على أن تكون المعرّفات متتالية.

هل ينشئ المفتاح الأساسي فهرسًا في PostgreSQL؟

نعم. ينشئ المفتاح الأساسي (وكل قيد UNIQUE) فهرس B-tree فريدًا تلقائيًا، اسمه tablename_pkey في حالة المفتاح الأساسي.

هل أستخدم UUID أم bigint للمفتاح الأساسي؟

مفاتيح identity من نوع bigint أصغر (8 بايت مقابل 16) وتُدرج بترتيب الفهرس. أما UUID فيمكن توليدها في أي مكان دون الرجوع إلى قاعدة البيانات، ولا تكشف عدد الصفوف. لكن UUID العشوائية تبعثر الإدراجات في الفهرس، وهذا أكثر تكلفة على الجداول الكبيرة.

رسم توضيحي للغات البرمجة في Coddy

تعلّم البرمجة مع Coddy

ابدأ الآن