ERROR: operator does not exist: json @> unknown
Operatorii de conținere și existență (@>, <@, ?, ?|, ?&) și jsonpath (@?, @@) există doar pentru jsonb, nu pentru json. Coloana ta e de tip json. Convertește valoarea (payload::jsonb @> ...) sau schimbă tipul coloanei în jsonb, ca să poți folosi și un index GIN.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Tipul json suportă doar navigarea (->, ->>, #>, #>>) și funcțiile de citire. Operatorii care compară structuri, @> („conține”), <@ („este conținut în”), ? („are cheia”), ?|, ?&, ||, - și operatorii jsonpath @?, @@ există doar pentru jsonb. Când îi aplici pe json, PostgreSQL caută operatorul pentru tipul json și nu îl găsește.
De obicei coloana a fost creată ca json din obișnuință sau într-o versiune veche. Conversia payload::jsonb rezolvă interogarea, dar fiecare rând se convertește la fiecare execuție, iar un index GIN nu poate fi folosit. Pe tabele interogate des, migrarea coloanei la jsonb și un CREATE INDEX ... USING gin (payload jsonb_path_ops) aduc interogările de la scanări complete la căutări în index.
De ce apare: cauzele frecvente
1@> pe coloană json
SELECT id FROM evenimente WHERE payload @> '{"tip": "login"}';SELECT id FROM evenimente WHERE payload::jsonb @> '{"tip": "login"}';Conversia face disponibil operatorul @>.
2Verificarea unei chei
SELECT id FROM evenimente WHERE payload ? 'utilizator';SELECT id FROM evenimente WHERE payload::jsonb ? 'utilizator';Operatorul ? există tot doar pentru jsonb.
Repară eroarea, direct în pagină
Tabelul evenimente are coloana payload de tip json. Căutarea evenimentelor de tip login cu @> dă operator does not exist: json @> unknown. Convertește payload-ul la jsonb în condiție și afișează id-urile găsite, ordonate.
SELECT id FROM evenimente
WHERE payload @> '{"tip": "login"}'
ORDER BY id;id ---- 1 2 (2 rânduri)
Indiciu
payload::jsonb @> ...
Reparația
SELECT id FROM evenimente
WHERE payload::jsonb @> '{"tip": "login"}'
ORDER BY id;De ce merge
Operatorul @> există doar pentru jsonb. Cu payload::jsonb, fiecare document este convertit, iar condiția verifică dacă îl conține pe {"tip": "login"}. Sunt găsite evenimentele 1 și 2. Pe un tabel mare, migrarea coloanei la jsonb și un index GIN ar evita conversia la fiecare rând.
Alte forme ale mesajului
ERROR: operator does not exist: json ? unknown
Cum o eviți pe viitor
- Creează coloanele de documente ca
jsonb. - Migrează coloanele
jsonvechi lajsonbcând începi să le filtrezi. - Adaugă un index GIN pe coloanele
jsonbfiltrate cu@>,?sau jsonpath. - Verifică planul cu
EXPLAINca să confirmi că indexul e folosit.
Întrebări frecvente
Ce diferență e între gin (doc) și gin (doc jsonb_path_ops)?
Clasa implicită suportă și operatorii de existență a cheilor (?, ?|, ?&); jsonb_path_ops suportă doar @> și jsonpath, dar e mai mică și mai rapidă.
Poate folosi un index conversia payload::jsonb?
Doar un index pe expresie identică: CREATE INDEX ON evenimente USING gin ((payload::jsonb)). Migrarea coloanei e mai simplă.
Erori înrudite
ERROR: could not identify an equality operator for type json Ai folosit DISTINCT, GROUP BY, UNION sau o comparație pe o coloană de tip json (nu jsonb). Tipul json păstrează textul exact și nu are operator de egalitate. Convertește la jsonb (col::jsonb) sau, mai bine, schimbă tipul coloanei în jsonb. ERROR: operator does not exist: jsonb = integer Compari o valoare jsonb (obținută cu -> sau cu doc['cheie']) cu un număr SQL. Cele două tipuri nu au un operator comun. Extrage valoarea ca text și convertește-o ((doc->>'cant')::int = 2), compară cu un literal jsonb (doc->'cant' = '2') sau folosește @>. ERROR: operator does not exist: text ->> unknown 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}'. Î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.
