RAISE() may only be used within a trigger-program
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
SELECT CASE WHEN stoc < 0
THEN RAISE(ABORT, 'stoc negativ') END
FROM produse;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
INSERT INTO produse (nume, pret) VALUES ('Mouse', -5);
SELECT RAISE(ABORT, 'pret negativ')
FROM produse WHERE pret < 0;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ă 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.
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;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.
Reparația
CREATE TRIGGER t_stoc BEFORE UPDATE OF stoc ON produse
WHEN NEW.stoc < 0
BEGIN
SELECT RAISE(ABORT, 'stoc negativ');
END;
UPDATE produse SET stoc = stoc - 3 WHERE id = 2;
SELECT nume, stoc FROM produse ORDER BY id;De ce merge
RAISE() oprește „comanda care a pornit triggerul”, deci există doar în corpul unui trigger. Triggerul t_stoc rulează înaintea fiecărui UPDATE al coloanei stoc și, dacă noua valoare (NEW.stoc) e negativă, anulează comanda cu mesajul 'stoc negativ'.
Hub USB-C are 4 bucăți, deci scăderea a 3 e permisă și stocul devine 1. O nouă scădere de 3 ar fi oprită de trigger.
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
CHECK constraint failed: pret >= 0 Valoarea pe care o inserezi sau o actualizezi încalcă o regulă CHECK din definiția tabelului (aici pret >= 0). Mesajul arată regula sau numele constrângerii. Corectează valoarea; schimbă regula doar dacă ea e cea greșită. cannot create INSTEAD OF trigger on table: produse Triggerele INSTEAD OF merg doar pe view-uri. Pe un tabel folosește BEFORE (ca să verifici sau să oprești o modificare) sau AFTER (ca să reacționezi după ea, de exemplu să scrii în jurnal). near "END": syntax error În corpul unui trigger, fiecare comandă dintre BEGIN și END trebuie să se termine cu punct și virgulă, inclusiv ultima. Ai scris ... VALUES ('x') END; fără ; înainte de END. Pune ; după fiecare comandă din trigger. Î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.
