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

ERROR: unterminated dollar-quoted string at or near "$$"

Pe scurt

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ă

Greșit
SQL
CREATE FUNCTION tva(p numeric) RETURNS numeric
LANGUAGE sql AS $$
  SELECT round(p * 1.19, 2);
Corect
SQL
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

Greșit
SQL
CREATE FUNCTION f() RETURNS int LANGUAGE sql AS $corp$
  SELECT 1;
$$;
Corect
SQL
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 ;

Greșit
SQL
-- unealta trimite doar până la primul ;
CREATE FUNCTION f() ... AS $$ BEGIN RETURN 1;
Corect
SQL
-- 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ă tu

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.

Codul care dă eroarea
SQL
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;
După reparație, programul afișează
CREATE FUNCTION
        nume        | pret_tva
--------------------+----------
 Mouse Wireless     |    70.81
 Tastatură Mecanică |   343.91
(2 rânduri)
Indiciu

Corpul funcției a fost deschis cu $$.

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

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