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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Dollar quoting ($$ ... $$) delimitează textul corpului unei funcții, ca să nu fie nevoie de dublarea apostrofurilor. PostgreSQL citește tot ce urmează după $$ ca text, până la următorul $$ identic. Dacă nu îl găsește, raportează textul neterminat și arată de unde a început.
Cauze: $$ final uitat, etichete diferite ($body$ deschis, $$ închis), sau un client care împarte scriptul la fiecare ; și trimite corpul funcției în bucăți (unele unelte de migrare sau drivere configurate greșit). În acest ultim caz, funcția e scrisă corect, dar unealta nu înțelege dollar quoting; soluția e configurarea separatorului de instrucțiuni în unealtă.
De ce apare: cauzele frecvente
1Delimitator final lipsă
CREATE FUNCTION tva(p numeric) RETURNS numeric
LANGUAGE sql AS $$
SELECT round(p * 1.19, 2);CREATE FUNCTION tva(p numeric) RETURNS numeric
LANGUAGE sql AS $$
SELECT round(p * 1.19, 2);
$$;Corpul trebuie închis cu același $$ cu care a fost deschis.
2Etichete diferite
CREATE FUNCTION f() RETURNS int LANGUAGE sql AS $corp$
SELECT 1;
$$;CREATE FUNCTION f() RETURNS int LANGUAGE sql AS $corp$
SELECT 1;
$corp$;Delimitatorul de închidere trebuie să aibă exact aceeași etichetă.
3Unealta împarte scriptul la ;
-- unealta trimite doar până la primul ;
CREATE FUNCTION f() ... AS $$ BEGIN RETURN 1;-- configurează unealta să respecte dollar quoting
-- (în Flyway și Liquibase: splitStatements sau delimitator personalizat)Funcția e corectă, dar clientul o trimite în bucăți. Problema se rezolvă în configurarea uneltei.
Repară eroarea, direct în pagină
Funcția care calculează prețul cu TVA dă unterminated dollar-quoted string. Închide corect corpul funcției, apoi afișează numele și prețul cu TVA ale produselor din categoria Accesorii, ordonate după nume.
CREATE FUNCTION pret_tva(p numeric) RETURNS numeric
LANGUAGE sql IMMUTABLE AS $$
SELECT round(p * 1.19, 2);
SELECT nume, pret_tva(pret) FROM produse WHERE categorie = 'Accesorii' ORDER BY nume;CREATE FUNCTION
nume | pret_tva
--------------------+----------
Mouse Wireless | 70.81
Tastatură Mecanică | 343.91
(2 rânduri)Indiciu
Corpul funcției a fost deschis cu $$.
Reparația
CREATE FUNCTION pret_tva(p numeric) RETURNS numeric
LANGUAGE sql IMMUTABLE AS $$
SELECT round(p * 1.19, 2);
$$;
SELECT nume, pret_tva(pret) FROM produse WHERE categorie = 'Accesorii' ORDER BY nume;De ce merge
Tot ce urmează după AS $$ este considerat text până la următorul $$. Fără delimitatorul de închidere, PostgreSQL consumă tot restul scriptului ca text. Cu $$; după corp, funcția se creează, iar interogarea o folosește. Dacă unealta ta de migrare împarte scripturile la fiecare ;, configureaz-o să respecte dollar quoting.
Cum o eviți pe viitor
- Scrie întâi scheletul complet (
AS $$...$$;), apoi completează corpul. - Folosește etichete descriptive (
$fn$) când ai dollar quoting imbricat și verifică perechile. - În migrări, folosește unelte care înțeleg dollar quoting sau marchează fișierul să nu fie împărțit la
;.
Întrebări frecvente
De ce nu folosesc apostrofuri pentru corpul funcției?
Poți, dar fiecare apostrof din corp trebuie dublat, iar corpurile cu texte devin greu de citit. Dollar quoting păstrează corpul exact cum e scris.
Pot avea $$ în interiorul corpului?
Da, dacă exteriorul folosește o etichetă: AS $fn$ ... $$ ... $$ ... $fn$. Interiorul $$ nu închide exteriorul $fn$.
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 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: query has no destination for result data Într-o funcție PL/pgSQL ai scris un SELECT al cărui rezultat nu e pus nicăieri. PL/pgSQL nu afișează rezultatele interogărilor. Folosește SELECT ... INTO variabila pentru a păstra valoarea, PERFORM pentru a o ignora sau RETURN QUERY pentru a o întoarce. Î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.
