Menu

تعديل جدول في PostgreSQL باستخدام ALTER TABLE

يعدّل ALTER TABLE جدولًا موجودًا: إضافة الأعمدة وإعادة تسميتها وحذفها، وتغيير نوع عمود باستخدام USING، وضبط القيم الافتراضية وNOT NULL، وإضافة القيود.

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

يعدّل ALTER TABLE جدولًا موجودًا بالفعل. أكثر الصيغ التي ستحتاجها هي ADD COLUMN وRENAME COLUMN ... TO وDROP COLUMN وALTER COLUMN ... TYPE. ويمكن وضع عدة إجراءات في جملة واحدة، مفصولة بفواصل.

تحصل الصفوف الموجودة على 'free' في plan وعلى NULL في signed_up. منذ PostgreSQL 11 لا تعيد إضافة عمود بقيمة افتراضية ثابتة كتابة الجدول، فهي سريعة حتى على الجداول الكبيرة. أما القيمة الافتراضية المتغيرة (volatile) مثل clock_timestamp() فما زالت تعيد كتابة كل صف.

إعادة تسمية عمود أو جدول

إعادة التسمية فورية وتحافظ على البيانات والفهارس والقيود. وتستمر العروض في العمل، لأنها تشير إلى المعرّف الداخلي للجدول لا إلى اسمه. أما الأسماء المكتوبة كنص في أماكن أخرى فلا تتبعه: أجسام دوال PL/pgSQL واستعلامات التطبيق ستبقى تستخدم الاسم القديم، فابحث عنه قبل إعادة التسمية.

حذف عمود

يحذف DROP COLUMN العمود وبياناته. ويفشل إذا كان هناك عرض أو مفتاح أجنبي يعتمد على العمود. يحذف CASCADE هذه أيضًا، ويتجاوز IF EXISTS الخطأ إذا كان العمود محذوفًا أصلًا.

لا يعيد PostgreSQL كتابة الجدول هنا، بل يعلّم العمود بأنه محذوف، وتعود المساحة كلما حُدّثت الصفوف أو أعيدت كتابة الجدول.

تغيير نوع عمود

يحوّل ALTER COLUMN ... TYPE كل قيمة. وحين لا يوجد تحويل تلقائي من النوع القديم إلى الجديد، أضف USING مع تعبير يحسب القيمة الجديدة:

بدون USING تفشل هذه الجملة بالخطأ column "price" cannot be cast automatically to type numeric. وإذا تعذّر تحويل قيمة واحدة، تفشل الجملة كلها ويبقى الجدول دون تغيير.

معظم تغييرات النوع تعيد كتابة الجدول، وبعضها لا يفعل: إطالة varchar(n)، أو تحويل varchar إلى text.

ضبط القيمة الافتراضية وNOT NULL أو إزالتهما

يمسح SET NOT NULL الجدول ويفشل إذا وُجد أي صف يحمل NULL، لذا املأ الفراغات أولًا:

يلغي DROP DEFAULT وDROP NOT NULL هذين الإعدادين. والقيمة الافتراضية الجديدة لا تنطبق إلا على الإدراجات المستقبلية، أما الصفوف الموجودة فتحتفظ بقيمها.

إضافة قيد

ALTER TABLE orders ADD CONSTRAINT total_positive CHECK (total > 0);
ALTER TABLE orders DROP CONSTRAINT total_positive;

إضافة CHECK أو مفتاح أجنبي تمسح الجدول كله للتحقق منه. على جدول كبير ومزدحم، أضفه أولًا مع NOT VALID، الذي لا يتحقق إلا من الصفوف الجديدة. ثم نفّذ ALTER TABLE orders VALIDATE CONSTRAINT total_positive;، الذي يتحقق من الصفوف القديمة تحت قفل أضعف يسمح باستمرار القراءة والكتابة. تستخدم صفحة المفاتيح الأجنبية النمط نفسه، ويسرد مرجع ALTER TABLE كل صيغة وقفلها.

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

هل يمكن تغيير ترتيب الأعمدة في PostgreSQL؟

لا. لا يستطيع ALTER TABLE نقل عمود، والأعمدة الجديدة تُضاف دائمًا في النهاية. اكتب الأعمدة بالترتيب الذي تريده في SELECT، أو أنشئ جدولًا جديدًا بذلك الترتيب وانسخ إليه البيانات.

هل يقفل ALTER TABLE الجدول في PostgreSQL؟

معظم الصيغ تأخذ قفل ACCESS EXCLUSIVE، الذي يحجب القراءة والكتابة حتى تنتهي الجملة. التغييرات السريعة (إعادة التسمية، وحذف عمود، وإضافة عمود بقيمة افتراضية ثابتة) تحتفظ به لحظة قصيرة فقط. أما تغيير النوع الذي يعيد كتابة الجدول فيحتفظ به طوال إعادة الكتابة.

كيف أضيف عدة أعمدة دفعة واحدة في PostgreSQL؟

افصل الإجراءات بفواصل في جملة واحدة: ALTER TABLE users ADD COLUMN phone text, ADD COLUMN city text;. كل الإجراءات داخل ALTER TABLE واحد تُنفَّذ معًا، بقفل واحد.

هل يمكن التراجع عن ALTER TABLE في PostgreSQL؟

نعم. أوامر DDL في PostgreSQL جزء من المعاملات، لذا يُلغى ALTER TABLE داخل BEGIN ... ROLLBACK بالكامل.

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

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

ابدأ الآن