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

ERROR: could not identify an equality operator for type json

Pe scurt

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.

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

Ce înseamnă

PostgreSQL are două tipuri JSON. json păstrează textul original exact (spații, ordinea cheilor, chei duplicate) și îl reanalizează la fiecare acces. jsonb stochează o formă binară normalizată, fără duplicate și cu cheile ordonate, deci două documente echivalente sunt egale. Din acest motiv, doar jsonb are operatori de egalitate, ordonare și conținere.

Orice operație care trebuie să compare valori json (DISTINCT, GROUP BY, UNION fără ALL, ORDER BY, =, IN) dă această eroare sau variante ca operator does not exist: json = json și operator does not exist: json @> unknown. Soluția punctuală este conversia col::jsonb. Soluția durabilă: ALTER TABLE ... ALTER COLUMN col TYPE jsonb USING col::jsonb. json merită păstrat doar când ai nevoie de textul exact, de exemplu pentru semnături sau audit.

De ce apare: cauzele frecvente

1DISTINCT pe o coloană json

Greșit
SQL
SELECT DISTINCT payload FROM evenimente;
Corect
SQL
SELECT DISTINCT payload::jsonb FROM evenimente;

jsonb are operator de egalitate.

2Conținere pe json

Greșit
SQL
SELECT * FROM evenimente WHERE payload @> '{"tip": "login"}';
Corect
SQL
ALTER TABLE evenimente ALTER COLUMN payload TYPE jsonb USING payload::jsonb;
SELECT * FROM evenimente WHERE payload @> '{"tip": "login"}';

Operatorii de conținere există doar pentru jsonb.

Repară tu

Repară eroarea, direct în pagină

Tabelul evenimente are coloana payload de tip json. Lista tipurilor distincte de payload dă could not identify an equality operator for type json. Schimbă tipul coloanei în jsonb și afișează payload-urile distincte, ordonate.

Codul care dă eroarea
SQL
SELECT DISTINCT payload FROM evenimente ORDER BY payload;
După reparație, programul afișează
ALTER TABLE
      payload
-------------------
 {"tip": "login"}
 {"tip": "logout"}
(2 rânduri)
Indiciu

ALTER TABLE evenimente ALTER COLUMN payload TYPE jsonb USING payload::jsonb

Alte forme ale mesajului

  • ERROR: operator does not exist: json = json
  • ERROR: could not identify an ordering operator for type json

Cum o eviți pe viitor

  • Folosește jsonb pentru documentele pe care le interoghezi, compari sau indexezi.
  • Păstrează json doar când textul original trebuie conservat exact.
  • Convertește coloanele vechi cu ALTER COLUMN ... TYPE jsonb USING col::jsonb.
  • Verifică tipul cu \d tabel când operatorii JSON nu funcționează cum te aștepți.

Întrebări frecvente

Sunt egale {"a":1,"b":2} și {"b":2,"a":1} în jsonb?

Da. jsonb nu ține cont de ordinea cheilor sau de spații.

Este jsonb mai lent la scriere?

Puțin, pentru că documentul e analizat și convertit la inserare. Citirile și interogările sunt în schimb mult mai rapide.

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.