...
Eroare SQL · Funcții JSON și text

bad JSON path: '$oras'

Pe scurt

Calea dată funcției JSON nu are forma corectă. În SQLite, o cale începe cu $ urmat de .cheie sau [index]: '$.oras', '$.adresa.oras', '$.produse[0]'. Ai uitat punctul după $ sau ai scris doar numele cheii fără $.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Funcțiile json_extract, json_set, json_remove și altele primesc o cale care spune ce parte din document vrei. Sintaxa ei:

  • $ înseamnă documentul întreg;
  • .cheie coboară într-un obiect: $.oras;
  • [n] ia elementul n dintr-un tablou, numărat de la 0: $.produse[0];
  • se pot înlănțui: $.livrare.adresa.oras.

bad JSON path: '$oras' înseamnă că textul căii nu respectă regulile: aici lipsește punctul dintre $ și cheie. Alte forme greșite: 'oras' (fără $), '$..oras', '$.produse.0'.

Excepție: operatorii -> și ->> acceptă și forma scurtă, doar cheia: detalii ->> 'oras'. Funcțiile json_... cer calea completă.

De ce apare: cauzele frecvente

1Lipsește punctul după $

Greșit
SQL
SELECT json_extract(detalii, '$oras')
FROM comenzi;
Corect
SQL
SELECT json_extract(detalii, '$.oras')
FROM comenzi;

Între rădăcina $ și numele cheii trebuie un punct.

2Doar numele cheii, ca la operatorul ->>

Greșit
SQL
SELECT json_extract(detalii, 'oras')
FROM comenzi;
Corect
SQL
SELECT detalii ->> 'oras'
FROM comenzi;

Mesajul aici este bad JSON path: 'oras'. Forma scurtă, fără $, merge doar cu -> și ->>; funcția vrea '$.oras'.

3Index de tablou scris cu punct

Greșit
SQL
SELECT json_extract(detalii, '$.produse.0')
FROM comenzi;
Corect
SQL
SELECT json_extract(detalii, '$.produse[0]')
FROM comenzi;

Elementele unui tablou se aleg cu paranteze drepte. Cu punct, 0 ar fi tratat ca numele unei chei și nu ar găsi nimic.

Repară tu

Repară eroarea, direct în pagină

Interogarea afișează pentru fiecare comandă orașul de livrare din JSON-ul din coloana detalii (id, oras), ordonate după id. Orașul e în livrare, sub cheia oras. Acum dă bad JSON path: '$livrare.oras'. Repară calea.

Codul care dă eroarea
SQL
SELECT id, json_extract(detalii, '$livrare.oras') AS oras
FROM comenzi
ORDER BY id;
După reparație, programul afișează
id | oras
1 | Iași
2 | Brașov
3 | Timișoara
Indiciu

După $ trebuie un punct înaintea primei chei.

Alte forme ale mesajului

  • bad JSON path: 'oras'
  • bad JSON path: '$..oras'
  • JSON path error near 'oras'
  • ERROR 3143 (42000): Invalid JSON path expression. The error is around character position 1.

Cum o eviți pe viitor

Scrie căile JSON mereu în forma completă '$.cheie', chiar și acolo unde forma scurtă ar merge, ca să fie la fel peste tot. Pentru cheile cu spații sau caractere speciale folosește ghilimele: '$."data livrare"'. Testează calea pe un singur document cu SELECT json_extract('{...}', '$.cale'); înainte s-o folosești pe tabel.

Întrebări frecvente

Ce întoarce o cale corectă care nu există în document?

NULL, fără eroare. Eroarea bad JSON path apare doar când calea e scrisă greșit, nu când cheia lipsește.

Cum iau ultimul element dintr-un tablou?

Cu '$.produse[#-1]'. # înseamnă lungimea tabloului, deci #-1 e ultimul index.

Erori înrudite

← Toate erorile SQL

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ță 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.