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

ERROR: unterminated quoted string at or near "'Iași;"

Pe scurt

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

Greșit
SQL
SELECT * FROM clienti WHERE oras = 'Iași;
Corect
SQL
SELECT * FROM clienti WHERE oras = 'Iași';

Textul trebuie închis înainte de ;, altfel tot restul devine parte din text.

2Apostrof în interiorul valorii

Greșit
SQL
INSERT INTO clienti (id, nume, email) VALUES (9, 'Patrick O'Brien', 'pob@x.ro');
Corect
SQL
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

Greșit
SQL
sql = "... WHERE nume = '" + nume + "'"
Corect
SQL
SELECT * FROM clienti WHERE nume = $1  -- valoarea trimisă ca parametru

Cu parametri, driverul trimite valoarea separat de SQL, deci apostrofurile nu mai pot strica instrucțiunea.

Repară tu

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.

Codul care dă eroarea
SQL
SELECT nume, email
FROM clienti
WHERE oras = 'Iași;
După reparație, programul afișează
     nume      |      email
---------------+------------------
 Mihai Ionescu | mihai@exemplu.ro
(1 rând)
Indiciu

Verifică dacă fiecare text deschis cu apostrof este și închis.

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 COPY cu 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

← 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.