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

ERROR: column "client_id" specified in USING clause does not exist in left table

Pe scurt

JOIN ... USING (coloana) cere ca ambele tabele să aibă o coloană cu exact acel nume. Dacă în tabelul din stânga coloana se numește altfel (id, nu client_id), folosește JOIN ... ON cu condiția explicită.

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

Ce înseamnă

USING (client_id) este o scurtătură pentru ON stanga.client_id = dreapta.client_id, care funcționează doar când coloana are același nume în ambele tabele. Mesajul spune în care parte lipsește: left table (tabelul de dinainte de JOIN) sau right table.

Cel mai des, tabelul părinte are cheia id, iar copilul are client_id: numele diferă, deci USING nu se poate folosi. Soluția este JOIN comenzi co ON co.client_id = c.id. USING e util când convenția de denumire folosește același nume peste tot (de exemplu client_id și în clienti), și are avantajul că rezultatul conține coloana o singură dată.

De ce apare: cauzele frecvente

1Chei cu nume diferite

Greșit
SQL
SELECT c.nume, co.total
FROM clienti c JOIN comenzi co USING (client_id);
Corect
SQL
SELECT c.nume, co.total
FROM clienti c JOIN comenzi co ON co.client_id = c.id;

În clienti cheia se numește id, deci legătura se scrie explicit cu ON.

2Nume scris greșit în USING

Greșit
SQL
SELECT * FROM comenzi JOIN linii USING (comand_id);
Corect
SQL
SELECT * FROM comenzi JOIN linii USING (comanda_id);

Numele din USING trebuie să existe exact așa în ambele tabele.

Repară tu

Repară eroarea, direct în pagină

Raportul dă column "client_id" specified in USING clause does not exist in left table. Rescrie JOIN-ul ca să afișeze numele clientului și totalul fiecărei comenzi, ordonate după total, de la cel mai mare.

Codul care dă eroarea
SQL
SELECT c.nume, co.total
FROM clienti c
JOIN comenzi co USING (client_id)
ORDER BY co.total DESC;
După reparație, programul afișează
     nume      |  total
---------------+---------
 Ana Pop       | 3559.40
 Mihai Ionescu | 1299.00
 Ana Pop       |  289.00
(3 rânduri)
Indiciu

În tabelul clienti, cheia se numește id.

Cum o eviți pe viitor

  • Folosește JOIN ... ON ca formă implicită; e explicită și nu depinde de nume identice.
  • Păstrează USING pentru tabele care respectă aceeași convenție de denumire.
  • Verifică numele coloanelor cu \d înainte să scrii JOIN-ul.
  • Păstrează o convenție de denumire unitară pentru chei în toată schema.

Întrebări frecvente

Ce diferență e între USING și ON în rezultat?

Cu USING (x), coloana x apare o singură dată în SELECT *. Cu ON, apar ambele coloane.

Pot pune mai multe coloane în USING?

Da, USING (a, b) leagă după ambele coloane. Toate trebuie să existe în ambele tabele.

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.