Wyzwalacz sprawia, że PostgreSQL automatycznie wywołuje funkcję, gdy tabela się zmienia. Najpierw napisz funkcję wyzwalacza zadeklarowaną jako RETURNS trigger, a potem ją podepnij: CREATE TRIGGER name BEFORE UPDATE ON table FOR EACH ROW EXECUTE FUNCTION fn();. Klasyczne zastosowanie to aktualna kolumna updated_at:
Zaktualizowano tylko post 1, więc tylko on ma znacznik czasu. NEW to wiersz, który zaraz zostanie zapisany; wyzwalacz BEFORE może go zmienić i musi go zwrócić. Tę samą funkcję możesz podpiąć do każdej tabeli z kolumną updated_at.
BEFORE vs AFTER vs INSTEAD OF
| Moment | Działa | Typowe użycie |
|---|---|---|
BEFORE | przed zapisaniem wiersza | zmiana lub walidacja NEW albo pominięcie wiersza |
AFTER | po zapisaniu wiersza | zapis do innych tabel: logi audytowe, liczniki |
INSTEAD OF | zamiast zmiany, tylko na widokach | umożliwienie zapisu do widoku |
FOR EACH ROW uruchamia funkcję raz na każdy zmieniony wiersz. FOR EACH STATEMENT (domyślnie) uruchamia ją raz na polecenie, nawet jeśli żaden wiersz się nie zmienił. W wyzwalaczu wierszowym NEW zawiera nowy wiersz (INSERT, UPDATE), a OLD poprzedni (UPDATE, DELETE). TG_OP podaje operację, która go uruchomiła, a TG_TABLE_NAME tabelę.
Wartość zwracana przez wierszowy wyzwalacz BEFORE decyduje, co się stanie: zwróć NEW (zmienione lub nie), żeby kontynuować, albo NULL, żeby pominąć wiersz bez błędu. Wartość zwracana przez wyzwalacz AFTER jest ignorowana, więc zwyczajowo zwraca on NULL.
Log audytowy z wyzwalaczem AFTER
Tabela audytu zapisuje dwa INSERT, jeden UPDATE z 10 na 12 i DELETE produktu za 20. Przy wstawieniu OLD to NULL, a przy usunięciu NEW to NULL, stąd coalesce. Żeby zapisać całe wiersze, umieść to_jsonb(OLD) i to_jsonb(NEW) w kolumnie jsonb.
Blokowanie albo pomijanie zmiany
Wyzwalacz BEFORE może odrzucić zmianę przez RAISE EXCEPTION, co przerywa polecenie, albo pominąć wiersz, zwracając NULL:
DELETE usunął szkic i po cichu zostawił opłaconą fakturę. Wyzwalacz BEFORE DELETE zwraca OLD, żeby przepuścić usunięcie. Żeby zamiast tego całe polecenie się nie udało, zamień RETURN NULL na RAISE EXCEPTION 'invoice % is paid', OLD.id;. Błąd łatwiej debugować niż wiersz, który po cichu zostaje.
Uruchamianie tylko przy zmianie kolumny
UPDATE OF column ogranicza wyzwalacz do aktualizacji, które ustawiają tę kolumnę. Warunek WHEN pomija wywołanie funkcji, gdy jest fałszywy. IS DISTINCT FROM traktuje NULL jak wartość, więc wyłapuje też zmiany na NULL i z NULL:
Pierwsza aktualizacja ustawia tę samą cenę, więc WHEN jest fałszywe, a licznik zostaje na 0. Druga ją zmienia i price_changed kończy na 1.
Listowanie, wyłączanie i usuwanie wyzwalaczy
-- 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;
W psql \d products wypisuje wyzwalacze tabeli. CREATE OR REPLACE TRIGGER istnieje od PostgreSQL 14, a EXECUTE FUNCTION od PostgreSQL 11; starszy kod pisze EXECUTE PROCEDURE, co nadal działa. Wyzwalacz, który zapisuje do własnej tabeli, może uruchomić sam siebie ponownie, więc zabezpiecz się przed pętlami (pg_trigger_depth() zwraca poziom zagnieżdżenia). Rozdział o funkcjach wyzwalaczy wymienia każdą zmienną TG_, a funkcje i procedury omawiają sam PL/pgSQL.
Najczęściej zadawane pytania
Czy wyzwalacz PostgreSQL może działać bez funkcji?
Nie. CREATE TRIGGER zawsze wywołuje funkcję zadeklarowaną jako RETURNS trigger. Najpierw napisz funkcję, zwykle w PL/pgSQL, a potem ją podepnij.
W jakiej kolejności uruchamiają się wyzwalacze na tej samej tabeli?
Wyzwalacze tego samego rodzaju na to samo zdarzenie uruchamiają się w alfabetycznej kolejności nazw. Dodaj do nazw przedrostki z cyframi albo literami, jeśli kolejność ma znaczenie.
Czy błąd w wyzwalaczu wycofuje polecenie?
Tak. Błąd zgłoszony w wyzwalaczu, na przykład przez RAISE EXCEPTION, przerywa polecenie, które go uruchomiło, i całą transakcję, chyba że przechwycisz go punktem zapisu.
Czy wyzwalacze uruchamiają się przy TRUNCATE?
Wyzwalacze DELETE na poziomie wierszy nie. Utwórz wyzwalacz na poziomie polecenia z BEFORE TRUNCATE albo AFTER TRUNCATE, żeby na to reagować.