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

ERROR: operator does not exist: text ->> unknown

Pe scurt

Ai înlănțuit ->> de două ori: doc->>'client'->>'oras'. Primul ->> întoarce text, iar pe text nu mai poți naviga în JSON. Folosește -> pentru pașii intermediari și ->> doar la final (doc->'client'->>'oras') sau calea completă: doc #>> '{client,oras}'.

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

Ce înseamnă

În PostgreSQL există două familii de operatori de acces în JSON: -> întoarce o valoare jsonb (pe care poți naviga mai departe), iar ->> întoarce text (valoarea finală, gata de afișat sau comparat). După un ->>, rezultatul nu mai e JSON, deci operatorul următor caută varianta text ->> unknown, care nu există.

Regula practică: -> pe toți pașii, ->> doar pe ultimul. Pentru căi lungi, #> și #>> primesc toată calea ca array de chei: doc #>> '{client,oras}'. Indexarea cu paranteze drepte (doc['client']['oras']), disponibilă din PostgreSQL 14, întoarce tot jsonb. Același mesaj, cu text -> unknown, apare dacă aplici -> pe o coloană text care conține JSON, dar nu are tipul json/jsonb; acolo soluția este conversia coloana::jsonb.

De ce apare: cauzele frecvente

1->> la mijlocul căii

Greșit
SQL
SELECT doc->>'client'->>'oras' FROM comenzi_json;
Corect
SQL
SELECT doc->'client'->>'oras' FROM comenzi_json;

Pasul intermediar rămâne jsonb, iar ultimul dă text.

2Cale lungă

Greșit
SQL
SELECT doc->'a'->'b'->'c'->>'d' FROM t;
Corect
SQL
SELECT doc #>> '{a,b,c,d}' FROM t;

#>> primește toată calea dintr-o dată.

3JSON stocat în coloană text

Greșit
SQL
SELECT payload->>'eveniment' FROM jurnal;  -- payload text
Corect
SQL
SELECT payload::jsonb->>'eveniment' FROM jurnal;

Textul trebuie convertit în jsonb înainte de navigare.

Repară tu

Repară eroarea, direct în pagină

Raportul vrea pentru fiecare comandă din comenzi_json id-ul și orașul clientului, dar dă operator does not exist: text ->> unknown. Repară calea în document și afișează rezultatele ordonate după id.

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

Pasul intermediar trebuie să rămână jsonb.

Alte forme ale mesajului

  • ERROR: operator does not exist: text -> unknown

Cum o eviți pe viitor

  • Ține minte regula: -> pentru navigare, ->> pentru valoarea finală.
  • Pentru căi lungi, folosește #>> cu un array de chei.
  • Stochează documentele JSON în coloane jsonb, nu text.
  • Convertește valoarea finală la tipul potrivit ((doc->>'total')::numeric) înainte de calcule.

Întrebări frecvente

Ce întoarce -> pe o cheie inexistentă?

NULL, fără eroare. La fel ->>. Valorile lipsă se tratează cu coalesce.

Ce diferență e între doc['a'] și doc->'a'?

Ambele întorc jsonb. Sintaxa cu paranteze drepte poate fi folosită și în UPDATE, pentru a modifica o cheie.

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.