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

ERROR: JSON object does not contain key "oras"

Pe scurt

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

Greșit
SQL
SELECT jsonb_path_query(doc, 'strict $.client.oras') FROM comenzi_json;
Corect
SQL
SELECT jsonb_path_query(doc, '$.client.oras') FROM comenzi_json;

În modul lax, documentele fără cheie nu produc rezultat.

2Erori suprimate explicit

Greșit
SQL
SELECT jsonb_path_query(doc, 'strict $.linii[*].sku') FROM comenzi_json;
Corect
SQL
SELECT jsonb_path_query(doc, 'strict $.linii[*].sku', silent => true) FROM comenzi_json;

silent => true ignoră erorile de structură.

Repară tu

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.

Codul care dă eroarea
SQL
SELECT id, jsonb_path_query(doc, 'strict $.client.oras') #>> '{}' AS oras
FROM comenzi_json
ORDER BY id;
După reparație, programul afișează
 id | oras
----+------
  1 | Cluj
  2 | Iași
(2 rânduri)
Indiciu

Scoate cuvântul strict; folosește #>> '{}' pentru text.

Alte forme ale mesajului

  • ERROR: jsonpath member accessor can only be applied to an object
  • ERROR: 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 @? sau jsonb_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

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