...
Eroare PostgreSQL · Funcții, proceduri și triggere PL/pgSQL

ERROR: "v_total" is not a known variable

Pe scurt

Atribui o valoare (v_total := ...) sau faci SELECT ... INTO într-o variabilă care nu a fost declarată în secțiunea DECLARE a funcției. Declară variabila cu tipul potrivit (v_total numeric;) sau corectează numele dacă e o greșeală de scriere.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

În PL/pgSQL, toate variabilele trebuie declarate în secțiunea DECLARE dinaintea lui BEGIN, cu tip. Când ținta unei atribuiri (:=) sau a unui INTO nu e o variabilă cunoscută, funcția nu se poate crea, iar mesajul numește identificatorul. Parametrii funcției sunt automat variabile și pot fi folosiți fără declarare.

Cauze frecvente: variabila lipsește din DECLARE; numele e scris diferit (v_totl); variabila e declarată într-un bloc interior (DECLARE ... BEGIN ... END imbricat) și folosită în afara lui; se încearcă atribuirea unei coloane de tabel ca și cum ar fi variabilă. Pentru tipuri, poți folosi %TYPE (v_total comenzi.total%TYPE), care urmează automat tipul coloanei, sau %ROWTYPE pentru un rând întreg.

De ce apare: cauzele frecvente

1Variabilă nedeclarată

Greșit
SQL
BEGIN
  v_total := 0;
Corect
SQL
DECLARE
  v_total numeric := 0;
BEGIN

Variabila e declarată, cu valoare inițială.

2Tip legat de coloană

Greșit
SQL
DECLARE v_total numeric(10,2);
Corect
SQL
DECLARE v_total comenzi.total%TYPE;

%TYPE urmează tipul coloanei, chiar dacă se schimbă.

Repară tu

Repară eroarea, direct în pagină

Funcția valoare_stoc calculează valoarea totală a stocului (preț × stoc), dar folosește variabila v_total fără să o declare și dă "v_total" is not a known variable. Declar-o cu tipul numeric și afișează rezultatul funcției.

Codul care dă eroarea
SQL
CREATE FUNCTION valoare_stoc() RETURNS numeric LANGUAGE plpgsql AS $$
BEGIN
  SELECT sum(pret * stoc) INTO v_total FROM produse;
  RETURN v_total;
END $$;
SELECT valoare_stoc();
După reparație, programul afișează
CREATE FUNCTION
 valoare_stoc
--------------
     23347.50
(1 rând)
Indiciu

DECLARE v_total numeric;

Cum o eviți pe viitor

  • Declară toate variabilele în DECLARE, cu prefixe consecvente (v_ pentru variabile, p_ pentru parametri).
  • Folosește %TYPE și %ROWTYPE ca tipurile să rămână sincronizate cu tabelele.
  • Inițializează variabilele la declarare când au o valoare de pornire.
  • Activează plpgsql_check pentru a găsi variabile nefolosite sau nedeclarate.

Întrebări frecvente

De ce sunt utile prefixele v_ și p_?

Evită conflictele cu numele coloanelor, care dau erori de tip column reference is ambiguous.

Pot declara variabile în mijlocul funcției?

Doar deschizând un bloc nou: DECLARE ... BEGIN ... END; în interiorul celui principal.

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.