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').
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
PostgreSQL delimitează textele cu apostrofuri. Când după un apostrof de deschidere nu mai găsește unul de închidere, raportează textul neterminat și arată de unde începe, în acest exemplu 'Iași;. Punctul și virgula a fost înghițit în text, deci instrucțiunea nu se mai termină.
Un apostrof în interiorul valorii produce aceeași familie de probleme: în 'Patrick O'Brien', al doilea apostrof închide textul prea devreme. În funcție de ce urmează, primești fie această eroare, fie syntax error at or near "Brien". Regula SQL este dublarea apostrofului din interior: 'O''Brien'. Alternativele sunt dollar quoting ($$O'Brien$$) și, în aplicații, parametrii: o valoare trimisă ca parametru nu trece prin parser, deci apostrofurile nu mai contează.
De ce apare: cauzele frecvente
1Apostrof de închidere uitat
SELECT * FROM clienti WHERE oras = 'Iași;SELECT * FROM clienti WHERE oras = 'Iași';Textul trebuie închis înainte de ;, altfel tot restul devine parte din text.
2Apostrof în interiorul valorii
INSERT INTO clienti (id, nume, email) VALUES (9, 'Patrick O'Brien', 'pob@x.ro');INSERT INTO clienti (id, nume, email) VALUES (9, 'Patrick O''Brien', 'pob@x.ro');Două apostrofuri consecutive într-un text înseamnă un apostrof literal.
3SQL construit prin concatenare în aplicație
sql = "... WHERE nume = '" + nume + "'"SELECT * FROM clienti WHERE nume = $1 -- valoarea trimisă ca parametruCu parametri, driverul trimite valoarea separat de SQL, deci apostrofurile nu mai pot strica instrucțiunea.
Repară eroarea, direct în pagină
Interogarea care caută clienții din Iași dă unterminated quoted string. Repar-o ca să afișeze numele și emailul clienților din Iași. Nu schimba restul interogării, doar textul cu problema.
SELECT nume, email
FROM clienti
WHERE oras = 'Iași;nume | email ---------------+------------------ Mihai Ionescu | mihai@exemplu.ro (1 rând)
Indiciu
Verifică dacă fiecare text deschis cu apostrof este și închis.
Reparația
SELECT nume, email
FROM clienti
WHERE oras = 'Iași';De ce merge
Textul 'Iași nu are apostroful de închidere, așa că PostgreSQL consideră că și ; face parte din el și ajunge la final fără să-l închidă. Cu 'Iași' complet, condiția compară orașul cu textul corect și întoarce clientul Mihai Ionescu. Aceeași verificare a perechilor de apostrofuri rezolvă și cazurile cu apostrof în interiorul valorii.
Alte forme ale mesajului
ERROR: syntax error at or near "Brien"
Cum o eviți pe viitor
- În aplicații, trimite valorile ca parametri (
$1,?), niciodată prin concatenare: e și protecția împotriva SQL injection. - În scripturi, dublează apostrofurile sau folosește
$$...$$pentru texte lungi. - Pentru importuri mari, folosește
COPYcu format CSV, care tratează corect ghilimelele. - Un editor cu evidențiere colorează restul instrucțiunii ca text atunci când un apostrof nu este închis.
Întrebări frecvente
Pot folosi backslash pentru apostrof, ca în MySQL?
Doar în textele de tip E'...': E'O\'Brien'. În textele obișnuite, backslash-ul este un caracter normal (cu standard_conforming_strings = on), deci forma standard rămâne dublarea apostrofului.
De ce e periculoasă concatenarea, dacă tot dau eroare?
Pentru că un utilizator poate trimite intenționat un text care închide apostroful și adaugă propriul SQL. Eroarea pe care o vezi este semnul că instrucțiunea poate fi manipulată.
Erori înrudite
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. ERROR: unterminated dollar-quoted string at or near "$$" Corpul unei funcții sau al unui bloc DO a fost deschis cu $$ (sau $eticheta$), dar nu a fost închis cu același delimitator. Adaugă $$ la finalul corpului, înainte de LANGUAGE sau de punct și virgulă, și verifică să nu folosești etichete diferite la deschidere și închidere. 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. Î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.
