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

ERROR: argument list must have even number of elements

Pe scurt

jsonb_build_object (sau json_build_object) primește perechi cheie, valoare. Ai dat un număr impar de argumente: lipsește o cheie sau o valoare, de obicei după ce ai adăugat sau șters un câmp. Verifică perechile, câte una pe rând.

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

Ce înseamnă

jsonb_build_object('a', 1, 'b', 2) construiește {"a": 1, "b": 2}: argumentele de pe pozițiile impare sunt chei, cele de pe pozițiile pare sunt valori. Un număr impar de argumente înseamnă că o cheie nu are valoare, iar PostgreSQL dă această eroare, cu HINT: The arguments of jsonb_build_object() must consist of alternating keys and values.

Când lista e lungă, o virgulă în plus sau o cheie uitată decalează toate perechile, iar rezultatul poate fi și mai ciudat dacă numărul rămâne par (chei care devin valori). Scrierea câte unei perechi pe rând face greșelile vizibile. Pentru a transforma un rând întreg în JSON, to_jsonb(rand) sau row_to_json sunt mai sigure decât enumerarea manuală, iar pentru a elimina câmpuri, to_jsonb(r) - 'camp'.

De ce apare: cauzele frecvente

1Valoare lipsă

Greșit
SQL
SELECT jsonb_build_object('nume', nume, 'oras') FROM clienti;
Corect
SQL
SELECT jsonb_build_object('nume', nume, 'oras', oras) FROM clienti;

Fiecare cheie are valoarea ei.

2Tot rândul ca JSON

Greșit
SQL
SELECT jsonb_build_object('id', id, 'nume', nume, 'email', email, 'oras', oras) FROM clienti;
Corect
SQL
SELECT to_jsonb(c) FROM clienti c;

to_jsonb folosește automat numele coloanelor ca chei.

Repară tu

Repară eroarea, direct în pagină

Endpointul de clienți construiește un obiect JSON cu numele și orașul, dar dă argument list must have even number of elements, pentru că valoarea orașului lipsește. Completează perechea și afișează documentul pentru fiecare client, ordonat după id.

Codul care dă eroarea
SQL
SELECT jsonb_build_object('nume', nume, 'oras') AS doc
FROM clienti
ORDER BY id;
După reparație, programul afișează
                    doc
-------------------------------------------
 {"nume": "Ana Pop", "oras": "Cluj"}
 {"nume": "Mihai Ionescu", "oras": "Iași"}
 {"nume": "Elena Dinu", "oras": null}
(3 rânduri)
Indiciu

Cheia 'oras' are nevoie de valoarea ei.

Cum o eviți pe viitor

  • Scrie câte o pereche cheie–valoare pe rând în apelurile lungi.
  • Folosește to_jsonb(rand) pentru a transforma rânduri întregi, apoi elimină câmpurile nedorite cu -.
  • Testează forma rezultatului cu jsonb_pretty înainte să-l trimiți în API.
  • Când adaugi un câmp, adaugă împreună cheia și valoarea, ca pereche, nu separat.

Întrebări frecvente

Pot construi cheile dinamic?

Da, cheile pot fi expresii: jsonb_build_object(cod, valoare). Pentru multe perechi din rânduri, folosește jsonb_object_agg(cheie, valoare).

Ce se întâmplă dacă o cheie este NULL?

Apare eroarea argument 1: key must not be null. Valorile pot fi însă NULL și devin null JSON.

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.