Trigger membuat PostgreSQL memanggil fungsi secara otomatis saat sebuah tabel berubah. Tulis dulu trigger function-nya, yang dideklarasikan RETURNS trigger, lalu pasang: CREATE TRIGGER name BEFORE UPDATE ON table FOR EACH ROW EXECUTE FUNCTION fn();. Pemakaian klasiknya adalah menjaga kolom updated_at tetap terkini:
Hanya post 1 yang diperbarui, jadi hanya post itu yang punya timestamp. NEW adalah baris yang akan ditulis; trigger BEFORE bisa mengubahnya dan harus mengembalikannya. Kamu bisa memasang fungsi yang sama ke setiap tabel yang punya kolom updated_at.
BEFORE vs AFTER vs INSTEAD OF
| Waktu | Berjalan | Pemakaian umum |
|---|---|---|
BEFORE | sebelum baris ditulis | mengubah atau memvalidasi NEW, atau melewati baris |
AFTER | setelah baris ditulis | menulis ke tabel lain: audit log, counter |
INSTEAD OF | menggantikan perubahan, hanya di view | membuat view bisa ditulis |
FOR EACH ROW menjalankan fungsi sekali per baris yang terpengaruh. FOR EACH STATEMENT (default) menjalankannya sekali per pernyataan, bahkan jika tidak ada baris yang berubah. Di trigger baris, NEW berisi baris baru (INSERT, UPDATE) dan OLD berisi baris sebelumnya (UPDATE, DELETE). TG_OP menyebut operasi yang memicunya dan TG_TABLE_NAME menyebut tabelnya.
Nilai kembalian trigger baris BEFORE menentukan apa yang terjadi: kembalikan NEW (diubah atau tidak) untuk melanjutkan, atau NULL untuk melewati baris tanpa error. Nilai kembalian trigger AFTER diabaikan, jadi menurut kebiasaan ia mengembalikan NULL.
Menulis audit log dengan trigger AFTER
Tabel audit mencatat dua INSERT, satu UPDATE dari 10 ke 12, dan satu DELETE untuk produk seharga 20. OLD bernilai NULL saat insert dan NEW bernilai NULL saat delete, karena itulah ada coalesce. Untuk menyimpan baris utuh, taruh to_jsonb(OLD) dan to_jsonb(NEW) di kolom jsonb.
Memblokir atau melewati perubahan
Trigger BEFORE bisa menolak perubahan dengan RAISE EXCEPTION, yang menghentikan pernyataan, atau melewati sebuah baris dengan mengembalikan NULL:
DELETE menghapus invoice draft dan diam-diam mempertahankan invoice yang sudah dibayar. Trigger BEFORE DELETE mengembalikan OLD untuk membiarkan penghapusan berjalan. Supaya seluruh pernyataan gagal, ganti RETURN NULL dengan RAISE EXCEPTION 'invoice % is paid', OLD.id;. Error lebih mudah di-debug daripada baris yang diam-diam tetap ada.
Hanya berjalan saat sebuah kolom berubah
UPDATE OF column membatasi trigger ke update yang mengisi kolom itu. Kondisi WHEN melewati pemanggilan fungsi saat bernilai false. IS DISTINCT FROM memperlakukan NULL sebagai nilai, jadi juga menangkap perubahan ke atau dari NULL:
Update pertama mengisi harga yang sama, jadi WHEN bernilai false dan counter tetap 0. Update kedua mengubahnya, dan price_changed berakhir di 1.
Melihat, menonaktifkan, dan menghapus trigger
-- 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;
Di psql, \d products menampilkan daftar trigger sebuah tabel. CREATE OR REPLACE TRIGGER ada sejak PostgreSQL 14, dan EXECUTE FUNCTION sejak PostgreSQL 11; kode lama menulis EXECUTE PROCEDURE, yang masih berjalan. Trigger yang menulis ke tabelnya sendiri bisa memicu dirinya lagi, jadi lindungi dari perulangan (pg_trigger_depth() mengembalikan tingkat kedalamannya). Bab trigger function memuat setiap variabel TG_, dan fungsi dan procedure membahas PL/pgSQL itu sendiri.
Pertanyaan yang sering diajukan
Bisakah trigger PostgreSQL berjalan tanpa fungsi?
Tidak bisa. CREATE TRIGGER selalu memanggil fungsi yang dideklarasikan RETURNS trigger. Tulis fungsinya dulu, biasanya dalam PL/pgSQL, lalu pasang.
Dalam urutan apa trigger di tabel yang sama dijalankan?
Trigger sejenis untuk event yang sama dijalankan berdasarkan urutan abjad namanya. Beri awalan angka atau huruf pada nama jika urutannya penting.
Apakah error di trigger membatalkan pernyataannya?
Ya. Error yang dimunculkan di trigger, misalnya dengan RAISE EXCEPTION, menghentikan pernyataan yang memicunya, dan seluruh transaksi kecuali kamu menangkapnya dengan savepoint.
Apakah trigger dijalankan saat TRUNCATE?
Trigger DELETE tingkat baris tidak. Buat trigger tingkat pernyataan dengan BEFORE TRUNCATE atau AFTER TRUNCATE untuk meresponsnya.