ERROR: cannot set path in scalar
jsonb_set (sau jsonb_insert) a primit ca document o valoare scalară (un număr, un text JSON sau null JSON), nu un obiect sau array. Nu ai unde seta o cheie într-un scalar. Verifică valoarea coloanei sau pornește de la un obiect gol: jsonb_set(coalesce(doc, '{}'), ...).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
jsonb_set(document, cale, valoare) modifică o cheie dintr-un obiect sau un element dintr-un array. Dacă documentul este un scalar JSON (5, "text", null), nu există o structură în care să se poată naviga, iar PostgreSQL dă această eroare. Variantele cannot delete from scalar (la operatorul -) și cannot replace existing key (la jsonb_insert pe o cheie existentă) au aceeași origine: operația nu se potrivește cu forma documentului.
Cazuri reale: o coloană de setări inițializată cu 'null'::jsonb sau cu '""' în loc de '{}'; un câmp care a primit un scalar dintr-un bug al aplicației. Atenție și la NULL SQL: jsonb_set(NULL, ...) întoarce NULL fără eroare, deci un UPDATE pe o coloană NULL „reușește”, dar nu salvează nimic. Soluția comună este coalesce și o valoare implicită '{}'::jsonb pe coloană.
De ce apare: cauzele frecvente
1Coloană inițializată cu null JSON
UPDATE setari SET pref = jsonb_set(pref, '{tema}', '"dark"'); -- pref = 'null'UPDATE setari SET pref = jsonb_set(CASE WHEN jsonb_typeof(pref) = 'object' THEN pref ELSE '{}' END, '{tema}', '"dark"');Pornind de la un obiect, cheia poate fi setată.
2NULL SQL care anulează în tăcere
UPDATE setari SET pref = jsonb_set(pref, '{tema}', '"dark"'); -- pref IS NULLUPDATE setari SET pref = jsonb_set(coalesce(pref, '{}'), '{tema}', '"dark"');Fără coalesce, rezultatul rămâne NULL.
3Alternativă simplă pentru chei de primul nivel
jsonb_set(pref, '{tema}', '"dark"')coalesce(pref, '{}') || '{"tema": "dark"}'Operatorul || combină obiecte și suprascrie cheia.
Repară eroarea, direct în pagină
Tabelul setari are preferințele utilizatorilor ca jsonb, dar pentru utilizatorul 2 valoarea este null JSON. Setarea temei „dark” pentru toți dă cannot set path in scalar. Pornește de la un obiect gol când valoarea nu e obiect și afișează utilizatorul și tema.
UPDATE setari SET pref = jsonb_set(pref, '{tema}', '"dark"');
SELECT utilizator, pref->>'tema' AS tema FROM setari ORDER BY utilizator;UPDATE 2
utilizator | tema
------------+------
1 | dark
2 | dark
(2 rânduri)Indiciu
CASE WHEN jsonb_typeof(pref) = 'object' THEN pref ELSE '{}' END
Reparația
UPDATE setari SET pref = jsonb_set(
CASE WHEN jsonb_typeof(pref) = 'object' THEN pref ELSE '{}' END,
'{tema}', '"dark"');
SELECT utilizator, pref->>'tema' AS tema FROM setari ORDER BY utilizator;De ce merge
'null'::jsonb este un scalar JSON, nu un obiect, deci jsonb_set nu are unde pune cheia. CASE înlocuiește orice valoare care nu e obiect cu '{}', iar jsonb_set adaugă cheia tema. Utilizatorul 1 își păstrează celelalte preferințe, iar utilizatorul 2 primește un obiect nou cu tema dark.
Alte forme ale mesajului
ERROR: cannot delete from scalarERROR: cannot replace existing key
Cum o eviți pe viitor
- Definește coloanele de documente cu
NOT NULL DEFAULT '{}'::jsonb. - Adaugă
CHECK (jsonb_typeof(pref) = 'object')pe coloanele care trebuie să fie obiecte. - Folosește
coalesce(doc, '{}')în actualizări pe date vechi. - Verifică numărul de rânduri modificate și valoarea rezultată după UPDATE-urile pe JSONB.
Întrebări frecvente
De ce nu dă jsonb_set eroare pe NULL?
Este o funcție STRICT: orice argument NULL produce NULL, fără să o mai execute.
Ce face create_if_missing?
Al patrulea argument (implicit true) creează cheia dacă lipsește, dar doar pe ultimul nivel al căii.
Erori înrudite
ERROR: cannot call jsonb_each on a non-object jsonb_each (sau jsonb_each_text, jsonb_object_keys) a primit un array sau un scalar în loc de obiect. Fie calea indică greșit, fie valoarea e o listă. Pentru array-uri folosește jsonb_array_elements; pentru date amestecate, verifică forma cu jsonb_typeof. ERROR: null value in column "email" of relation "clienti" violates not-null constraint Un INSERT sau UPDATE lasă fără valoare (NULL) o coloană declarată NOT NULL. De obicei coloana a fost omisă din lista INSERT și nu are DEFAULT, sau aplicația trimite NULL. Completează valoarea, adaugă un DEFAULT potrivit sau, dacă valoarea lipsă e legitimă, scoate constrângerea. ERROR: cannot get array length of a non-array jsonb_array_length a primit un obiect sau un scalar în loc de array, de obicei pentru că documentele nu au toate aceeași structură (o comandă cu o singură linie stocată ca obiect, nu ca listă). Verifică tipul cu jsonb_typeof înainte sau normalizează documentele. Î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.
