Menu

المشغّلات في PostgreSQL: ‏CREATE TRIGGER بالأمثلة

يشغّل المشغّل (trigger) دالة تلقائيًا حين تُدرج الصفوف أو تُحدَّث أو تُحذف. في PostgreSQL تكتب دالة مشغّل تعيد trigger، ثم تربطها بجدول باستخدام CREATE TRIGGER.

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

يجعل المشغّل PostgreSQL يستدعي دالة تلقائيًا حين يتغير جدول. اكتب دالة المشغّل أولًا، معرّفة بـ RETURNS trigger، ثم اربطها: CREATE TRIGGER name BEFORE UPDATE ON table FOR EACH ROW EXECUTE FUNCTION fn();. والاستخدام الكلاسيكي هو إبقاء عمود updated_at محدّثًا:

حُدّث المنشور 1 فقط، فهو وحده لديه طابع زمني. NEW هو الصف الذي يوشك أن يُكتب، ويستطيع مشغّل BEFORE تغييره ويجب أن يعيده. ويمكنك ربط الدالة نفسها بكل جدول فيه عمود updated_at.

BEFORE مقابل AFTER مقابل INSTEAD OF

التوقيتيعملالاستخدام المعتاد
BEFOREقبل كتابة الصفتغيير NEW أو التحقق منه، أو تخطي الصف
AFTERبعد كتابة الصفالكتابة في جداول أخرى: سجلات التدقيق، والعدّادات
INSTEAD OFبدل التغيير، على العروض فقطجعل العرض قابلًا للكتابة

يشغّل FOR EACH ROW الدالة مرة لكل صف متأثر. ويشغّلها FOR EACH STATEMENT (الافتراضي) مرة لكل جملة، حتى لو لم يتغير أي صف. وفي مشغّل الصف يحمل NEW الصف الجديد (INSERT وUPDATE) ويحمل OLD الصف السابق (UPDATE وDELETE). ويحمل TG_OP اسم العملية التي أطلقته، وTG_TABLE_NAME اسم الجدول.

قيمة الإرجاع من مشغّل صف من نوع BEFORE تحدد ما يحدث: أعد NEW (معدّلًا أو لا) للمتابعة، أو NULL لتخطي الصف دون خطأ. أما قيمة إرجاع مشغّل AFTER فتُتجاهل، لذا يعيد NULL بحكم العرف.

كتابة سجل تدقيق بمشغّل AFTER

يسجّل جدول التدقيق عمليتَي INSERT، وUPDATE من 10 إلى 12، وDELETE للمنتج الذي سعره 20. يكون OLD ‏NULL في الإدراج وNEW ‏NULL في الحذف، ومن هنا الحاجة إلى coalesce. ولتخزين صفوف كاملة ضع to_jsonb(OLD) وto_jsonb(NEW) في عمود jsonb.

منع تغيير أو تخطيه

يستطيع مشغّل BEFORE رفض تغيير بـ RAISE EXCEPTION، الذي يلغي الجملة، أو تخطي صف بإعادة NULL:

حذف DELETE المسودة وأبقى الفاتورة المدفوعة بصمت. يعيد مشغّل BEFORE DELETE القيمة OLD ليسمح بإتمام الحذف. ولجعل الجملة كلها تفشل بدلًا من ذلك، استبدل RETURN NULL بـ RAISE EXCEPTION 'invoice % is paid', OLD.id;. فالخطأ أسهل في التتبع من صف يبقى بصمت.

التشغيل فقط حين يتغير عمود

يحصر UPDATE OF column المشغّل في التحديثات التي تضبط ذلك العمود. ويتخطى شرط WHEN استدعاء الدالة حين يكون false. ويعامل IS DISTINCT FROM ‏NULL كقيمة، فيلتقط أيضًا التغيير إلى NULL ومنه:

يضبط التحديث الأول السعر نفسه، فيكون WHEN ‏false ويبقى العدّاد عند 0. أما الثاني فيغيّره، فينتهي price_changed عند 1.

عرض المشغّلات وتعطيلها وحذفها

-- triggers you created (excludes the ones behind foreign keys)
SELECT tgrelid::regclass AS table_name, tgname
FROM pg_trigger WHERE NOT tgisinternal;

ALTER TABLE products DISABLE TRIGGER products_price;
ALTER TABLE products ENABLE TRIGGER products_price;
DROP TRIGGER products_price ON products;

في psql يسرد \d products مشغّلات الجدول. يوجد CREATE OR REPLACE TRIGGER منذ PostgreSQL 14، وEXECUTE FUNCTION منذ PostgreSQL 11، والشيفرة الأقدم تكتب EXECUTE PROCEDURE، وما زالت تعمل. والمشغّل الذي يكتب في جدوله قد يطلق نفسه من جديد، فاحترس من الحلقات (تعيد pg_trigger_depth() مستوى التداخل). يسرد فصل دوال المشغّلات كل متغيرات TG_، وتشرح صفحة الدوال والإجراءات لغة PL/pgSQL نفسها.

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

هل يمكن لمشغّل في PostgreSQL أن يعمل دون دالة؟

لا. يستدعي CREATE TRIGGER دائمًا دالة معرّفة بـ RETURNS trigger. اكتب الدالة أولًا، بـ PL/pgSQL عادةً، ثم اربطها.

بأي ترتيب تعمل المشغّلات على الجدول نفسه؟

تعمل المشغّلات من النوع نفسه على الحدث نفسه بالترتيب الأبجدي لأسمائها. أضف بادئة من أرقام أو أحرف إلى الأسماء إن كان الترتيب مهمًا.

هل يتراجع خطأ المشغّل عن الجملة؟

نعم. الخطأ الذي يُرفع في مشغّل، مثلًا بـ RAISE EXCEPTION، يلغي الجملة التي أطلقته، والمعاملة كلها ما لم تلتقطه بنقطة حفظ.

هل تعمل المشغّلات مع TRUNCATE؟

مشغّلات DELETE على مستوى الصف لا تعمل. أنشئ مشغّلًا على مستوى الجملة بـ BEFORE TRUNCATE أو AFTER TRUNCATE لتستجيب له.

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

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

ابدأ الآن