...
Eroare PostgreSQL · Sintaxă și nume de obiecte

ERROR: syntax error at or near "["

Pe scurt

Încerci să iei un element dintr-un array returnat de o expresie sau funcție (ARRAY[...][1], array_agg(...)[1], string_to_array(...)[2]). PostgreSQL acceptă indicele doar după o coloană sau după o expresie pusă între paranteze: (array_agg(nume))[1].

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

Ce înseamnă

Sintaxa cu paranteze drepte funcționează direct pe o coloană de tip array (etichete[1]) sau pe o variabilă. Pentru orice altă expresie, gramatica PostgreSQL cere ca expresia să fie pusă între paranteze înainte de indice: (ARRAY[10,20,30])[2], (string_to_array('a,b,c', ','))[2], (array_agg(nume ORDER BY id))[1].

Fără paranteze, parserul citește apelul funcției, apoi găsește [ acolo unde nu se așteaptă și se oprește. Reține și că indicii pornesc de la 1, iar un indice în afara array-ului întoarce NULL, nu eroare. Pentru documente JSONB, indexarea cu paranteze drepte (PostgreSQL 14+) urmează alte reguli și pornește de la 0.

De ce apare: cauzele frecvente

1Indice direct după un apel de funcție

Greșit
SQL
SELECT string_to_array('Pop Ana', ' ')[2];
Corect
SQL
SELECT (string_to_array('Pop Ana', ' '))[2];

Expresia trebuie pusă între paranteze ca să i se poată aplica indicele.

2Primul element dintr-un agregat

Greșit
SQL
SELECT categorie, array_agg(nume ORDER BY pret)[1]
FROM produse GROUP BY categorie;
Corect
SQL
SELECT categorie, (array_agg(nume ORDER BY pret))[1]
FROM produse GROUP BY categorie;

Același lucru pentru agregate: parantezele în jurul lui array_agg fac indicele valid.

Repară tu

Repară eroarea, direct în pagină

Interogarea vrea să afișeze prenumele fiecărui client (al doilea cuvânt din nume, de exemplu Pop din Ana Pop), dar dă syntax error at or near "[". Repar-o, păstrând string_to_array, cu clienții ordonați după id.

Codul care dă eroarea
SQL
SELECT nume, string_to_array(nume, ' ')[2] AS al_doilea
FROM clienti
ORDER BY id;
După reparație, programul afișează
     nume      | al_doilea
---------------+-----------
 Ana Pop       | Pop
 Mihai Ionescu | Ionescu
 Elena Dinu    | Dinu
(3 rânduri)
Indiciu

Expresia căreia îi aplici indicele trebuie pusă între paranteze.

Cum o eviți pe viitor

  • Pune între paranteze orice expresie căreia vrei să-i aplici un indice.
  • Pentru „primul după o ordine”, alternativele mai clare sunt DISTINCT ON sau min()/max() când e posibil.
  • Ține minte că array-urile PostgreSQL încep de la 1.
  • Testează expresia separat, cu SELECT, înainte s-o folosești într-o interogare mare.

Întrebări frecvente

De ce merge etichete[1], dar nu funcție(...)[1]?

Gramatica acceptă indicele imediat după un nume de coloană sau variabilă. Pentru expresii, ambiguitatea din gramatică este rezolvată cerând paranteze.

Ce întoarce un indice care nu există?

NULL. (ARRAY[1,2])[5] nu dă eroare, deci verifică lungimea cu cardinality() dacă e important.

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.