...
Eroare PostgreSQL · Tipuri de date, operatori și conversii

ERROR: malformed array literal: "gaming,office"

Pe scurt

Textul convertit într-un array nu are formatul PostgreSQL pentru array-uri: lipsesc acoladele ({gaming,office}), sau e JSON ([...]), sau e o listă separată prin virgule. Scrie literalul cu acolade, folosește constructorul ARRAY['a','b'] sau transformă textul cu string_to_array.

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

Ce înseamnă

Literalii de array în PostgreSQL au forma '{a,b,c}', cu acolade, virgule ca separator și ghilimele duble pentru elementele cu spații sau virgule ('{"Cluj-Napoca","Baia Mare"}'). Orice alt format dă această eroare, cu textul în mesaj și uneori un DETAIL (Array value must start with "{" or dimension information.).

Cazuri tipice: o listă din formular sau CSV (gaming,office) trimisă direct într-o coloană text[]; un array JSON (["a","b"]) folosit ca literal PostgreSQL; ghilimele simple în interiorul acoladelor. Soluțiile: constructorul ARRAY['gaming', 'office'], care nu are nevoie de escapare; string_to_array('gaming,office', ',') pentru liste separate; pentru JSON, ARRAY(SELECT jsonb_array_elements_text(...)). În aplicații, driverele transmit array-urile native fără să construiești textul manual.

De ce apare: cauzele frecvente

1Listă separată prin virgule

Greșit
SQL
INSERT INTO articole VALUES ('Mouse', 'gaming,office');
Corect
SQL
INSERT INTO articole VALUES ('Mouse', string_to_array('gaming,office', ','));

string_to_array desparte textul în elemente.

2Array JSON folosit ca literal

Greșit
SQL
SELECT '["a","b"]'::text[];
Corect
SQL
SELECT ARRAY(SELECT jsonb_array_elements_text('["a","b"]'));

Elementele JSON sunt extrase și puse într-un array PostgreSQL.

3Constructor în loc de literal

Greșit
SQL
INSERT INTO articole VALUES ('Mouse', '{gaming, office mobil}');
Corect
SQL
INSERT INTO articole VALUES ('Mouse', ARRAY['gaming', 'office mobil']);

ARRAY[...] evită problemele de escapare.

Repară tu

Repară eroarea, direct în pagină

Formularul de produs trimite etichetele ca text separat prin virgule („gaming,office”), iar inserarea în coloana etichete text[] dă malformed array literal: "gaming,office". Transformă textul în array cu string_to_array și afișează numele și numărul de etichete pentru fiecare articol.

Codul care dă eroarea
SQL
INSERT INTO articole VALUES ('Mouse Wireless', 'gaming,office');
SELECT nume, cardinality(etichete) AS nr FROM articole ORDER BY nume;
După reparație, programul afișează
INSERT 0 1
      nume      | nr
----------------+----
 Laptop Nova    |  1
 Mouse Wireless |  2
(2 rânduri)
Indiciu

string_to_array('gaming,office', ',')

Cum o eviți pe viitor

  • Folosește constructorul ARRAY[...] în SQL scris de mână.
  • Transformă listele text cu string_to_array și curăță spațiile cu trim.
  • Lasă driverul aplicației să transmită array-urile ca tip nativ.
  • Pentru liste cu structură (obiecte, atribute), consideră jsonb sau un tabel separat.

Întrebări frecvente

Cum scriu un element cu virgulă în literal?

Între ghilimele duble: '{"Ana, Ion",Dan}'. Cu ARRAY['Ana, Ion', 'Dan'] nu e nevoie de escapare.

De la ce index încep array-urile?

De la 1, nu de la 0. etichete[1] este primul element.

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.