ERROR: there is no parameter $1
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
SELECT * FROM comenzi WHERE client_id = $1;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
await pool.query('SELECT * FROM comenzi WHERE client_id = $1');await pool.query('SELECT * FROM comenzi WHERE client_id = $1', [clientId]);Valorile parametrilor se trimit ca al doilea argument.
3Parametri într-un bloc DO
DO $$ BEGIN PERFORM * FROM comenzi WHERE client_id = $1; END $$;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ă 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.
SELECT id, total FROM comenzi WHERE client_id = $1 ORDER BY id;PREPARE id | total ----+--------- 1 | 3559.40 2 | 289.00 (2 rânduri)
Indiciu
PREPARE definește parametrii, EXECUTE le dă valori.
Reparația
PREPARE comenzi_client(int) AS
SELECT id, total FROM comenzi WHERE client_id = $1 ORDER BY id;
EXECUTE comenzi_client(1);De ce merge
PREPARE comenzi_client(int) AS ... declară că $1 este un întreg, iar EXECUTE comenzi_client(1) rulează interogarea cu valoarea 1. Așa se comportă și driverul aplicației, care trimite valoarea separat de textul SQL. Instrucțiunea pregătită rămâne disponibilă până la finalul sesiunii sau până la DEALLOCATE comenzi_client.
Cum o eviți pe viitor
- În aplicație, verifică faptul că numărul de parametri trimiși corespunde cu
$1..$ndin 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șiEXECUTE. - 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
ERROR: unterminated quoted string at or near "'Iași;" Un text început cu apostrof nu are apostroful de închidere până la finalul instrucțiunii. Cauza tipică este un apostrof final uitat sau un apostrof din interiorul valorii (O'Brien) care strică perechile. Închide textul și dublează apostrofurile din interior ('O''Brien'). ERROR: column "nume_client" does not exist PostgreSQL nu găsește coloana cu numele din mesaj în tabelele din FROM. Cauze tipice: nume scris greșit, un text pus între ghilimele duble în loc de apostrofuri, un alias din SELECT folosit în WHERE sau o coloană creată cu majuscule între ghilimele. ERROR: syntax error at end of input Instrucțiunea s-a terminat înainte ca PostgreSQL să primească tot ce aștepta: o paranteză neînchisă, un WHERE fără condiție, un ghilimele sau un bloc neterminat. Completează partea lipsă de la finalul instrucțiunii. Î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.
