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

ERROR: operator does not exist: json @> unknown

Pe scurt

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

Greșit
SQL
SELECT id FROM evenimente WHERE payload @> '{"tip": "login"}';
Corect
SQL
SELECT id FROM evenimente WHERE payload::jsonb @> '{"tip": "login"}';

Conversia face disponibil operatorul @>.

2Verificarea unei chei

Greșit
SQL
SELECT id FROM evenimente WHERE payload ? 'utilizator';
Corect
SQL
SELECT id FROM evenimente WHERE payload::jsonb ? 'utilizator';

Operatorul ? există tot doar pentru jsonb.

Repară tu

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.

Codul care dă eroarea
SQL
SELECT id FROM evenimente
WHERE payload @> '{"tip": "login"}'
ORDER BY id;
După reparație, programul afișează
 id
----
  1
  2
(2 rânduri)
Indiciu

payload::jsonb @> ...

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 json vechi la jsonb când începi să le filtrezi.
  • Adaugă un index GIN pe coloanele jsonb filtrate cu @>, ? sau jsonpath.
  • Verifică planul cu EXPLAIN ca 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

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