...
Eroare PostgreSQL · JSONB, array-uri și căutare full-text

ERROR: cannot set path in scalar

Pe scurt

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

Greșit
SQL
UPDATE setari SET pref = jsonb_set(pref, '{tema}', '"dark"');  -- pref = 'null'
Corect
SQL
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

Greșit
SQL
UPDATE setari SET pref = jsonb_set(pref, '{tema}', '"dark"');  -- pref IS NULL
Corect
SQL
UPDATE setari SET pref = jsonb_set(coalesce(pref, '{}'), '{tema}', '"dark"');

Fără coalesce, rezultatul rămâne NULL.

3Alternativă simplă pentru chei de primul nivel

Greșit
SQL
jsonb_set(pref, '{tema}', '"dark"')
Corect
SQL
coalesce(pref, '{}') || '{"tema": "dark"}'

Operatorul || combină obiecte și suprascrie cheia.

Repară tu

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.

Codul care dă eroarea
SQL
UPDATE setari SET pref = jsonb_set(pref, '{tema}', '"dark"');
SELECT utilizator, pref->>'tema' AS tema FROM setari ORDER BY utilizator;
După reparație, programul afișează
UPDATE 2
 utilizator | tema
------------+------
          1 | dark
          2 | dark
(2 rânduri)
Indiciu

CASE WHEN jsonb_typeof(pref) = 'object' THEN pref ELSE '{}' END

Alte forme ale mesajului

  • ERROR: cannot delete from scalar
  • ERROR: 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

← 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.