טריגר גורם ל-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 | במקום השינוי, רק על views | לאפשר כתיבה ל-view |
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, מבטלת את הפקודה שהפעילה אותו, ואת כל הטרנזקציה אלא אם תופסים אותה עם savepoint.
האם טריגרים רצים ב-TRUNCATE?
טריגרי DELETE ברמת השורה לא רצים. צרו טריגר ברמת הפקודה עם BEFORE TRUNCATE או AFTER TRUNCATE כדי להגיב לו.