KeyError: 'id_client'
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
t = comenzi.merge(clienti, on="id_client") # în clienti: "id"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
t = comenzi.merge(clienti, on="id_client")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
clienti = clienti.set_index("id_client")
t = comenzi.merge(clienti, on="id_client")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ă 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.
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"]])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".
Reparația
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, left_on="id_client", right_on="id")
print(t[["id_comanda", "nume", "suma"]])De ce merge
on="id_client" cere coloana id_client în ambele tabele, dar în clienti ea se numește id. Cu left_on și right_on, spui separat numele cheii în fiecare tabel, iar pandas compară valorile: comanda 101 are clientul 2, deci primește numele Ion Toma. Ordinea comenzilor se păstrează.
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_clientpeste 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
pandas.errors.MergeError: No common columns to perform merge on. Merge options: left_on=None, right_on=None, left_index=False, right_index=False Ai apelat merge fără on, iar cele două tabele nu au nicio coloană cu același nume după care să fie unite. Spune explicit cheia: merge(..., left_on="cod_produs", right_on="cod") sau redenumește coloana ca să aibă același nume în ambele tabele. ValueError: You are trying to merge on int64 and str columns for key 'id_client'. If you wish to proceed you should use pd.concat Cheia de unire are tipuri diferite în cele două tabele: într-unul e număr (int64), în celălalt text (str), de exemplu pentru că a fost citită cu zerouri în față sau cu spații. Adu cheia la același tip înainte de merge, de obicei cu astype(str) pe ambele sau pd.to_numeric pe cea de text. KeyError: 'Pret' DataFrame-ul nu are o coloană cu exact numele 'Pret'. Coloanele sunt sensibile la majuscule, spații și diacritice: afișează print(df.columns.tolist()) și folosește numele exact, de exemplu df["pret"]. Î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.
