...
Eroare SQL · Triggere și view-uri

RAISE() may only be used within a trigger-program

Pe scurt

Funcția RAISE(ABORT, 'mesaj') merge doar în corpul unui trigger. Ai folosit-o într-un SELECT obișnuit. Pune verificarea într-un trigger BEFORE INSERT/UPDATE cu WHEN, sau, pentru reguli simple, într-o constrângere CHECK.

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

Ce înseamnă

RAISE() e felul în care un trigger din SQLite oprește o modificare: RAISE(ABORT, 'stoc insuficient') anulează comanda curentă și afișează mesajul tău, RAISE(ROLLBACK, ...) anulează toată tranzacția, iar RAISE(IGNORE) sare peste rândul curent.

Pentru că acțiunea se referă la „comanda care a pornit triggerul”, funcția nu are sens în afara unui trigger. Folosită într-un SELECT, UPDATE sau CASE obișnuit, dă RAISE() may only be used within a trigger-program.

Cine vine din PostgreSQL (RAISE EXCEPTION) sau SQL Server (RAISERROR, THROW) încearcă de obicei să valideze datele direct în script. În SQLite, validarea stă în schemă: CHECK pentru reguli pe rând, triggere pentru reguli care citesc alte tabele.

De ce apare: cauzele frecvente

1Validare cu RAISE într-un SELECT

Greșit
SQL
SELECT CASE WHEN stoc < 0
  THEN RAISE(ABORT, 'stoc negativ') END
FROM produse;
Corect
SQL
CREATE TRIGGER t_stoc BEFORE UPDATE OF stoc ON produse
WHEN NEW.stoc < 0
BEGIN
  SELECT RAISE(ABORT, 'stoc negativ');
END;

Triggerul verifică fiecare UPDATE al stocului și îl oprește, cu mesajul tău, înainte ca valoarea negativă să fie salvată.

2Regulă simplă pe rând

Greșit
SQL
INSERT INTO produse (nume, pret) VALUES ('Mouse', -5);
SELECT RAISE(ABORT, 'pret negativ')
FROM produse WHERE pret < 0;
Corect
SQL
CREATE TABLE produse (
  id INTEGER PRIMARY KEY,
  nume TEXT,
  pret INTEGER CHECK (pret >= 0)
);

Pentru o regulă care privește doar rândul, CHECK e mai simplu: SQLite refuză singur valoarea cu CHECK constraint failed.

Repară tu

Repară eroarea, direct în pagină

Stocul unui produs nu are voie să devină negativ. Scriptul încearcă să verifice asta cu RAISE într-un SELECT și dă RAISE() may only be used within a trigger-program. Repară-l: creează un trigger BEFORE UPDATE OF stoc care oprește cu mesajul 'stoc negativ' orice UPDATE cu stoc sub 0, apoi scade 3 bucăți din Hub USB-C și afișează nume, stoc ordonate după id.

Codul care dă eroarea
SQL
SELECT CASE WHEN stoc - 3 < 0 THEN RAISE(ABORT, 'stoc negativ') END
FROM produse WHERE id = 2;
UPDATE produse SET stoc = stoc - 3 WHERE id = 2;
SELECT nume, stoc FROM produse ORDER BY id;
După reparație, programul afișează
nume | stoc
Mouse wireless | 25
Hub USB-C | 1
Cablu HDMI | 60
Indiciu

RAISE își are locul în corpul unui trigger, cu condiția pusă în WHEN.

Alte forme ale mesajului

  • sqlite3.OperationalError: RAISE() may only be used within a trigger-program

Cum o eviți pe viitor

Pune regulile de validare în schemă, nu în interogări: CHECK pentru condiții pe rândul curent, REFERENCES pentru existența în alt tabel, triggere BEFORE ... WHEN condiție BEGIN SELECT RAISE(ABORT, 'mesaj'); END; pentru reguli care citesc alte rânduri. Scrie mesaje clare în RAISE, pentru că ele ajung până în aplicație ca text al erorii.

Întrebări frecvente

Ce mesaj vede aplicația la RAISE(ABORT, 'stoc negativ')?

Exact textul tău: stoc negativ. De aceea merită să fie clar și să spună ce regulă a fost încălcată.

ABORT, FAIL sau ROLLBACK?

ABORT anulează doar comanda curentă (implicit, cel mai folosit). ROLLBACK anulează toată tranzacția. FAIL oprește comanda, dar păstrează rândurile modificate deja de ea.

Erori înrudite

← Toate erorile SQL

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ță SQL de la zero, cu exerciții la fiecare lecție

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