ERROR: JSON object does not contain key "oras"
O expresie jsonpath în modul strict a cerut o cheie care lipsește dintr-un document. În modul strict, structura trebuie să existe exact. Folosește modul lax (implicit, fără cuvântul strict), care sare peste cheile lipsă, sau adaugă un filtru care verifică existența.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Funcțiile jsonpath (jsonb_path_query, jsonb_path_exists, jsonb_path_match, operatorii @? și @@) au două moduri. În lax, implicit, erorile de structură sunt ignorate: o cheie lipsă nu produce nimic, un obiect singur e tratat ca array cu un element. În strict, aceleași situații dau erori: JSON object does not contain key "oras", jsonpath member accessor can only be applied to an object, jsonpath array accessor can only be applied to an array.
Modul strict e util când vrei să validezi structura documentelor; pentru rapoarte pe date reale, neuniforme, modul lax e aproape mereu cel potrivit. O a treia variantă: funcțiile primesc parametrul silent => true, care suprimă erorile de structură chiar și în modul strict. Pentru verificarea existenței unei chei folosești exists(...) în filtru sau operatorul ?.
De ce apare: cauzele frecvente
1Cheie lipsă în modul strict
SELECT jsonb_path_query(doc, 'strict $.client.oras') FROM comenzi_json;SELECT jsonb_path_query(doc, '$.client.oras') FROM comenzi_json;În modul lax, documentele fără cheie nu produc rezultat.
2Erori suprimate explicit
SELECT jsonb_path_query(doc, 'strict $.linii[*].sku') FROM comenzi_json;SELECT jsonb_path_query(doc, 'strict $.linii[*].sku', silent => true) FROM comenzi_json;silent => true ignoră erorile de structură.
Repară eroarea, direct în pagină
Raportul listează orașele clienților cu jsonb_path_query în modul strict, dar comanda 3 nu are orașul, iar interogarea dă JSON object does not contain key "oras". Treci la modul lax și afișează id-ul și orașul (ca text) pentru documentele care îl au.
SELECT id, jsonb_path_query(doc, 'strict $.client.oras') #>> '{}' AS oras
FROM comenzi_json
ORDER BY id;id | oras ----+------ 1 | Cluj 2 | Iași (2 rânduri)
Indiciu
Scoate cuvântul strict; folosește #>> '{}' pentru text.
Reparația
SELECT id, jsonb_path_query(doc, '$.client.oras') #>> '{}' AS oras
FROM comenzi_json
ORDER BY id;De ce merge
În modul strict, o cheie lipsă este o eroare. În modul lax, implicit, documentul 3 pur și simplu nu produce niciun rând, iar celelalte două își dau orașul. #>> '{}' transformă valoarea jsonb rezultată în text simplu, fără ghilimele, pentru afișare.
Alte forme ale mesajului
ERROR: jsonpath member accessor can only be applied to an objectERROR: jsonpath array accessor can only be applied to an array
Cum o eviți pe viitor
- Folosește modul lax (implicit) pentru interogări pe date reale.
- Păstrează modul strict pentru validări, unde vrei să afli că structura e greșită.
- Pentru verificarea existenței, folosește
@?saujsonb_path_exists. - Testează expresiile jsonpath pe documente cu chei lipsă și cu structuri diferite.
Întrebări frecvente
Ce face @? față de @@?
doc @? '$.client.oras' întreabă dacă expresia găsește ceva; doc @@ '$.total > 100' evaluează un predicat. Ambele pot folosi index GIN.
Ce întoarce jsonb_path_query pentru documentele fără rezultat?
Zero rânduri pentru acel document. Varianta jsonb_path_query_first întoarce NULL.
Erori înrudite
ERROR: syntax error at end of jsonpath input Expresia jsonpath (al doilea argument din jsonb_path_query, sau textul de după @? și @@) are o greșeală de sintaxă: punct la final, paranteze neînchise, texte între ghilimele simple în loc de duble, operatorul = în loc de ==. Corectează expresia; textele din jsonpath se scriu între ghilimele duble. 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: 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.
