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

ERROR: there is no parameter $1

Pe scurt

Ai trimis o interogare care conține $1 (un parametru), dar fără valori pentru parametri, de exemplu rulând-o direct în psql sau construind-o greșit în aplicație. Parametrii $1, $2 au sens doar în instrucțiuni pregătite sau în funcții; în psql folosești valori concrete sau PREPARE/EXECUTE.

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

Ce înseamnă

$1, $2 sunt locuri pentru valori trimise separat de textul SQL, prin protocolul extins (drivere, PREPARE) sau în corpul funcțiilor SQL. Când PostgreSQL primește o interogare simplă care conține $1, nu are de unde lua valoarea și dă această eroare.

Situații tipice: copiezi o interogare din logurile aplicației (unde apar parametrii) și o rulezi în psql; folosești un driver care nu trimite parametrii pentru că apelul e greșit (de exemplu query(sql) în loc de query(sql, [valoare])); scrii $1 într-un bloc DO, care nu are parametri. Pentru teste în psql, PREPARE q(int) AS ...; EXECUTE q(5); reproduce exact comportamentul aplicației, inclusiv planul generic.

De ce apare: cauzele frecvente

1Interogare din log rulată în psql

Greșit
SQL
SELECT * FROM comenzi WHERE client_id = $1;
Corect
SQL
PREPARE comenzi_client(int) AS
  SELECT * FROM comenzi WHERE client_id = $1;
EXECUTE comenzi_client(1);

Cu PREPARE, parametrul are tip și primește valoarea la EXECUTE.

2Driver apelat fără valori

Greșit
SQL
await pool.query('SELECT * FROM comenzi WHERE client_id = $1');
Corect
SQL
await pool.query('SELECT * FROM comenzi WHERE client_id = $1', [clientId]);

Valorile parametrilor se trimit ca al doilea argument.

3Parametri într-un bloc DO

Greșit
SQL
DO $$ BEGIN PERFORM * FROM comenzi WHERE client_id = $1; END $$;
Corect
SQL
DO $$ DECLARE v_client int := 1; BEGIN PERFORM * FROM comenzi WHERE client_id = v_client; END $$;

Un bloc DO nu primește parametri; folosești variabile declarate.

Repară tu

Repară eroarea, direct în pagină

Interogarea copiată din logurile aplicației dă there is no parameter $1. Transformă-o într-o instrucțiune pregătită numită comenzi_client și execut-o pentru clientul cu id-ul 1, ca să afișeze id-ul și totalul comenzilor lui, ordonate după id.

Codul care dă eroarea
SQL
SELECT id, total FROM comenzi WHERE client_id = $1 ORDER BY id;
După reparație, programul afișează
PREPARE
 id |  total
----+---------
  1 | 3559.40
  2 |  289.00
(2 rânduri)
Indiciu

PREPARE definește parametrii, EXECUTE le dă valori.

Cum o eviți pe viitor

  • În aplicație, verifică faptul că numărul de parametri trimiși corespunde cu $1..$n din SQL.
  • Când copiezi interogări din loguri, activează logarea parametrilor (log_parameter_max_length) sau înlocuiește-i cu valori.
  • Pentru depanare în psql, folosește PREPARE și EXECUTE.
  • Nu înlocui parametrii cu texte concatenate doar ca să scapi de eroare.

Întrebări frecvente

De ce PostgreSQL folosește $1 și nu ? ca MySQL?

Protocolul PostgreSQL numerotează parametrii. Unele drivere (JDBC, psycopg) acceptă ? sau %s și le transformă în $1, $2 înainte de trimitere.

Pot folosi același parametru de două ori?

Da: WHERE a = $1 OR b = $1 folosește aceeași valoare de două ori, fără să o trimiți din nou.

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.