...
Eroare Python pentru analiza datelor · Combinarea tabelelor: merge și concat

KeyError: 'id_client'

Pe scurt

Ai unit tabelele cu merge(on="id_client"), dar cheia nu se numește așa în ambele tabele (de exemplu în clienți e "id"). Când cheia are nume diferite, folosește left_on="id_client", right_on="id", sau redenumește coloana înainte de merge.

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

Ce înseamnă

on="id_client" cere ca ambele tabele să aibă o coloană cu exact numele id_client. Dacă unul dintre ele o numește id, cod_client sau ID_Client, pandas nu o găsește și ridică KeyError cu numele căutat. Mesajul nu spune în care dintre tabele lipsește, deci verifică stanga.columns și dreapta.columns.

Situația e foarte frecventă: tabelele vin din sisteme diferite, iar fiecare își numește coloanele cum vrea. merge are pentru asta parametrii left_on și right_on, care primesc numele cheii din fiecare tabel. După unire, ambele coloane rămân în rezultat; poți renunța la una cu drop(columns="id").

Aceeași eroare apare dacă cheia are un spațiu în plus sau o majusculă, ori dacă e indexul tabelului, nu o coloană (atunci folosești right_index=True).

De ce apare: cauzele frecvente

1Cheia are nume diferite în cele două tabele

Greșit
PYTHON
t = comenzi.merge(clienti, on="id_client")   # în clienti: "id"
Corect
PYTHON
t = comenzi.merge(clienti, left_on="id_client", right_on="id")

left_on e numele cheii în tabelul din stânga, right_on în cel din dreapta. Valorile se compară, nu numele.

2Redenumire înainte de unire

Greșit
PYTHON
t = comenzi.merge(clienti, on="id_client")
Corect
PYTHON
clienti = clienti.rename(columns={"id": "id_client"})
t = comenzi.merge(clienti, on="id_client")

Cu același nume în ambele tabele, on= funcționează, iar rezultatul are o singură coloană cheie.

3Cheia e în index

Greșit
PYTHON
clienti = clienti.set_index("id_client")
t = comenzi.merge(clienti, on="id_client")
Corect
PYTHON
t = comenzi.merge(clienti, left_on="id_client", right_index=True)

După set_index, id_client nu mai e coloană. right_index=True folosește indexul tabelului din dreapta drept cheie.

Repară tu

Repară eroarea, direct în pagină

Vrei să adaugi numele clientului la fiecare comandă. În tabelul comenzi cheia se numește id_client, iar în clienti se numește id, deci merge(on="id_client") dă KeyError: 'id_client'. Repară unirea și afișează comanda, numele clientului și suma.

Codul care dă eroarea
PYTHON
import pandas as pd

comenzi = pd.DataFrame({
    "id_comanda": [101, 102, 103, 104],
    "id_client": [2, 1, 2, 3],
    "suma": [250, 120, 480, 90],
})
clienti = pd.DataFrame({
    "id": [1, 2, 3],
    "nume": ["Ana Pop", "Ion Toma", "Maria Dinu"],
})

t = comenzi.merge(clienti, on="id_client")
print(t[["id_comanda", "nume", "suma"]])
După reparație, programul afișează
   id_comanda        nume  suma
0         101    Ion Toma   250
1         102     Ana Pop   120
2         103    Ion Toma   480
3         104  Maria Dinu    90
Indiciu

Folosește left_on="id_client" și right_on="id".

Alte forme ale mesajului

  • KeyError: 'id'
  • KeyError: 'cod_produs'

Cum o eviți pe viitor

  • Înainte de merge, afișează coloanele ambelor tabele și caută cheia în fiecare.
  • Adoptă un nume unic pentru fiecare cheie în tot proiectul (id_client peste tot) și redenumește imediat după citire.
  • Folosește validate="many_to_one" la unire, ca să afli dacă cheia din dreapta are duplicate.
  • Verifică numărul de rânduri înainte și după unire.

Întrebări frecvente

După left_on / right_on am două coloane cheie. E normal?

Da: pandas păstrează ambele coloane, pentru că au nume diferite. Au aceleași valori pe rândurile unite, deci poți elimina una cu t.drop(columns="id").

De ce merge-ul fără on nu dă eroarea asta?

Fără on, pandas caută singur coloanele cu același nume. Dacă nu există niciuna, primești MergeError: No common columns to perform merge on; dacă există una nepotrivită (de exemplu nume), unește după ea, ceea ce e și mai periculos.

Erori înrudite

← Toate erorile Python pentru analiza datelor

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ță Python pentru analiza datelor de la zero, cu exerciții la fiecare lecție

Curs Data Analysis with Python: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.