Menu

PostgreSQL Trigger: Örneklerle CREATE TRIGGER

Bir tetikleyici (trigger), satırlar eklendiğinde, güncellendiğinde ya da silindiğinde bir fonksiyonu otomatik çalıştırır. PostgreSQL'de önce trigger döndüren bir fonksiyon yazarsın, sonra onu CREATE TRIGGER ile bir tabloya bağlarsın.

Bu sayfada çalıştırılabilir editörler var. Düzenle, çalıştır ve sonucu anında gör.

Bir tetikleyici (trigger), bir tablo değiştiğinde PostgreSQL'in bir fonksiyonu otomatik olarak çağırmasını sağlar. Önce RETURNS trigger olarak tanımlanmış trigger fonksiyonunu yaz, sonra onu bağla: CREATE TRIGGER name BEFORE UPDATE ON table FOR EACH ROW EXECUTE FUNCTION fn();. Klasik kullanımı bir updated_at sütununu güncel tutmaktır:

Sadece 1 numaralı gönderi güncellendi, bu yüzden sadece onun bir zaman damgası var. NEW yazılmak üzere olan satırdır; bir BEFORE trigger'ı onu değiştirebilir ve onu döndürmek zorundadır. Aynı fonksiyonu updated_at sütunu olan her tabloya bağlayabilirsin.

BEFORE, AFTER ve INSTEAD OF

ZamanlamaNe zaman çalışırTipik kullanım
BEFOREsatır yazılmadan önceNEW'i değiştirmek ya da doğrulamak, veya satırı atlamak
AFTERsatır yazıldıktan sonrabaşka tablolara yazmak: audit log'lar, sayaçlar
INSTEAD OFdeğişikliğin yerine, sadece görünümlerdebir görünümü yazılabilir yapmak

FOR EACH ROW fonksiyonu etkilenen her satır için bir kez çalıştırır. FOR EACH STATEMENT (varsayılan) ise hiçbir satır değişmese bile her komut için bir kez çalıştırır. Satır trigger'ında NEW yeni satırı (INSERT, UPDATE), OLD ise öncekini (UPDATE, DELETE) tutar. TG_OP onu tetikleyen işlemin, TG_TABLE_NAME ise tablonun adını verir.

Bir BEFORE satır trigger'ının dönüş değeri ne olacağını belirler: devam etmek için NEW (değişmiş ya da değişmemiş) döndür, satırı hatasız atlamak için NULL döndür. Bir AFTER trigger'ının dönüş değeri yok sayılır, bu yüzden geleneksel olarak NULL döndürür.

AFTER trigger ile audit log yazma

Audit tablosu iki INSERT, 10'dan 12'ye bir UPDATE ve fiyatı 20 olan ürünün DELETE işlemini kaydeder. Bir insert'te OLD, bir delete'te ise NEW NULL'dır; coalesce bu yüzden var. Satırların tamamını saklamak için to_jsonb(OLD) ve to_jsonb(NEW) değerlerini bir jsonb sütununa koy.

Bir değişikliği engelleme ya da atlama

Bir BEFORE trigger'ı bir değişikliği komutu iptal eden RAISE EXCEPTION ile reddedebilir ya da NULL döndürerek bir satırı atlayabilir:

DELETE taslağı sildi ve ödenmiş faturayı sessizce tuttu. Bir BEFORE DELETE trigger'ı silmenin devam etmesi için OLD döndürür. Bunun yerine tüm komutun başarısız olmasını istiyorsan RETURN NULL satırını RAISE EXCEPTION 'invoice % is paid', OLD.id; ile değiştir. Bir hatanın hatasını ayıklamak, sessizce yerinde kalan bir satırınkinden daha kolaydır.

Sadece bir sütun değiştiğinde çalıştırma

UPDATE OF column, trigger'ı o sütunu ayarlayan güncellemelerle sınırlar. Bir WHEN koşulu false olduğunda fonksiyon çağrısını atlar. IS DISTINCT FROM, NULL'ı bir değer gibi ele alır, bu yüzden NULL'a ya da NULL'dan yapılan değişiklikleri de yakalar:

İlk güncelleme aynı fiyatı ayarlar, bu yüzden WHEN false olur ve sayaç 0'da kalır. İkincisi fiyatı değiştirir ve price_changed 1'de biter.

Trigger'ları listeleme, devre dışı bırakma ve silme

-- 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'de \d products bir tablonun trigger'larını listeler. CREATE OR REPLACE TRIGGER PostgreSQL 14'ten, EXECUTE FUNCTION ise PostgreSQL 11'den beri var; eski kodlar hâlâ çalışan EXECUTE PROCEDURE yazımını kullanır. Kendi tablosuna yazan bir trigger kendini yeniden tetikleyebilir, bu yüzden döngülere karşı önlem al (pg_trigger_depth() iç içelik seviyesini döndürür). Trigger fonksiyonları bölümü tüm TG_ değişkenlerini listeler, fonksiyonlar ve prosedürler ise PL/pgSQL'in kendisini anlatır.

Sıkça Sorulan Sorular

PostgreSQL'de bir trigger fonksiyon olmadan çalışabilir mi?

Hayır. CREATE TRIGGER her zaman RETURNS trigger olarak tanımlanmış bir fonksiyonu çağırır. Önce fonksiyonu, genelde PL/pgSQL ile yaz, sonra bağla.

Aynı tablodaki trigger'lar hangi sırayla çalışır?

Aynı olay için aynı türdeki trigger'lar adlarının alfabetik sırasına göre çalışır. Sıra önemliyse adların başına sayı ya da harf koy.

Trigger'daki bir hata komutu geri alır mı?

Evet. Bir trigger içinde, örneğin RAISE EXCEPTION ile fırlatılan hata, onu tetikleyen komutu iptal eder; bir savepoint ile yakalamadıkça tüm transaction'ı da.

Trigger'lar TRUNCATE'te çalışır mı?

Satır düzeyindeki DELETE trigger'ları çalışmaz. Ona tepki vermek için BEFORE TRUNCATE ya da AFTER TRUNCATE ile komut düzeyinde bir trigger oluştur.

Coddy programlama dilleri çizimi

Coddy ile kodlamayı öğren

Başla