...
Eroare PostgreSQL · Funcții, proceduri și triggere PL/pgSQL

ERROR: trigger functions can only be called as triggers

Pe scurt

Ai apelat direct (SELECT functie()) o funcție declarată RETURNS trigger. Funcțiile trigger rulează doar când sunt legate de un tabel cu CREATE TRIGGER și se declanșează la INSERT, UPDATE sau DELETE. Creează trigger-ul și testează funcția printr-o operație pe tabel.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

O funcție RETURNS trigger primește automat context de la PostgreSQL: rândurile NEW și OLD, operația (TG_OP), tabelul (TG_TABLE_NAME), momentul (TG_WHEN). Fără acest context, apelul direct nu are sens, așa că PostgreSQL îl refuză cu această eroare. Funcția se leagă de un tabel cu CREATE TRIGGER nume BEFORE|AFTER INSERT OR UPDATE ON tabel FOR EACH ROW EXECUTE FUNCTION functie().

Mesajul apare des când cineva vrea să „testeze” funcția înainte de a crea trigger-ul sau încearcă să o refolosească pentru o actualizare manuală. Pentru testare, rulează operația pe tabel într-o tranzacție pe care o anulezi. Dacă logica trebuie folosită și în afara trigger-ului, mut-o într-o funcție obișnuită, apelată atât din trigger, cât și direct.

De ce apare: cauzele frecvente

1Apel direct pentru test

Greșit
SQL
SELECT actualizeaza_modificat();
Corect
SQL
CREATE TRIGGER t_modificat BEFORE UPDATE ON produse FOR EACH ROW EXECUTE FUNCTION actualizeaza_modificat();
UPDATE produse SET stoc = stoc WHERE id = 1;

Funcția rulează prin trigger, la o operație pe tabel.

2Logică refolosită

Greșit
SQL
-- vrei aceeași regulă și din cod
Corect
SQL
CREATE FUNCTION calc_tva(p numeric) RETURNS numeric ...;  -- obișnuită
-- trigger-ul o apelează: NEW.pret_tva := calc_tva(NEW.pret);

Logica comună stă într-o funcție obișnuită.

Repară tu

Repară eroarea, direct în pagină

Funcția trigger marcheaza_modificat completează coloana modificat la fiecare UPDATE pe produse, dar cineva o testează cu SELECT și primește trigger functions can only be called as triggers. Creează trigger-ul BEFORE UPDATE, actualizează stocul tastaturii și afișează dacă modificat e completat.

Codul care dă eroarea
SQL
SELECT marcheaza_modificat();
UPDATE produse SET stoc = 11 WHERE id = 3;
SELECT stoc, modificat IS NOT NULL AS marcat FROM produse WHERE id = 3;
După reparație, programul afișează
CREATE TRIGGER
UPDATE 1
 stoc | marcat
------+--------
   11 | t
(1 rând)
Indiciu

CREATE TRIGGER ... BEFORE UPDATE ON produse FOR EACH ROW EXECUTE FUNCTION marcheaza_modificat();

Cum o eviți pe viitor

  • Testează trigger-ele prin operații reale pe tabel, în tranzacții anulate.
  • Păstrează logica reutilizabilă în funcții obișnuite, apelate din trigger.
  • Denumește funcțiile trigger clar (de exemplu cu prefixul trg_).
  • Verifică trigger-ele unui tabel cu \d tabel (secțiunea Triggers).

Întrebări frecvente

Poate o funcție trigger să fie folosită de mai multe tabele?

Da, dacă folosește doar coloane comune sau TG_TABLE_NAME pentru ramuri.

Ce diferență e între EXECUTE FUNCTION și EXECUTE PROCEDURE?

Sunt echivalente; EXECUTE PROCEDURE este forma veche, păstrată pentru compatibilitate.

Erori înrudite

← Toate erorile PostgreSQL

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață PostgreSQL de la zero, cu exerciții la fiecare lecție

Curs PostgreSQL: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 10 lecții sunt gratuite.