ValueError: 'outter' is not a valid Merge type: left, right, inner, outer, left_anti, right_anti, cross, asof
Valoarea dată lui how= la merge nu e una dintre cele acceptate (aici „outter”, scris greșit). Folosește exact una din listă: "inner", "left", "right", "outer" sau "cross". Un FULL OUTER JOIN din SQL se scrie how="outer".
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Parametrul how al lui merge spune ce rânduri păstrezi: inner (doar cheile comune, implicit), left (toate din stânga), right (toate din dreapta), outer (toate din ambele), cross (toate combinațiile). pandas 3 a adăugat și left_anti / right_anti (rândurile fără pereche). Orice alt text e refuzat, iar mesajul îți afișează lista completă.
Greșelile tipice vin din SQL: "full", "full outer", "left outer" sau "left join". În pandas se scrie doar un cuvânt, fără „join” și fără „outer” la left/right.
În versiunile mai vechi de pandas, lista din mesaj e mai scurtă (fără left_anti și right_anti), iar unele dau un MergeError diferit; cauza e aceeași.
De ce apare: cauzele frecvente
1Greșeală de tastare
pd.merge(clienti, comenzi, on="id_client", how="outter")pd.merge(clienti, comenzi, on="id_client", how="outer")outer se scrie cu un singur t.
2Denumiri din SQL
pd.merge(a, b, on="id", how="full outer")
pd.merge(a, b, on="id", how="left outer")pd.merge(a, b, on="id", how="outer")
pd.merge(a, b, on="id", how="left")FULL OUTER JOIN este outer, iar LEFT (OUTER) JOIN este left.
3Rândurile fără pereche
pd.merge(clienti, comenzi, on="id_client", how="anti")m = pd.merge(clienti, comenzi, on="id_client", how="left", indicator=True)
fara = m[m["_merge"] == "left_only"]anti nu există; indicator=True merge în orice versiune, iar în pandas 3 există și how="left_anti".
Repară eroarea, direct în pagină
Codul de mai jos unește clienții cu comenzile, păstrând și clienții fără comenzi și comenzile fără client cunoscut, dar dă ValueError: 'outter' is not a valid Merge type: .... Repară-l ca să afișeze numărul de rânduri și câte rânduri are fiecare sursă.
import pandas as pd
clienti = pd.DataFrame({"id_client": [1, 2, 3], "nume": ["Ana", "Dan", "Ioana"]})
comenzi = pd.DataFrame({"id_client": [1, 1, 4], "valoare": [120, 80, 300]})
m = pd.merge(clienti, comenzi, on="id_client", how="outter", indicator=True)
print(len(m))
print(m["_merge"].value_counts().sort_index().to_dict())5
{'left_only': 2, 'right_only': 1, 'both': 2}Indiciu
Unirea care păstrează toate rândurile din ambele tabele este how="outer".
Reparația
import pandas as pd
clienti = pd.DataFrame({"id_client": [1, 2, 3], "nume": ["Ana", "Dan", "Ioana"]})
comenzi = pd.DataFrame({"id_client": [1, 1, 4], "valoare": [120, 80, 300]})
m = pd.merge(clienti, comenzi, on="id_client", how="outer", indicator=True)
print(len(m))
print(m["_merge"].value_counts().sort_index().to_dict())De ce merge
outter nu e o valoare acceptată, iar outer păstrează toate cheile din ambele tabele. Ana are două comenzi (2 rânduri both), Dan și Ioana nu au comenzi (2 rânduri left_only), iar comanda clientului 4 nu are client (1 rând right_only). În total, 5 rânduri.
Alte forme ale mesajului
ValueError: 'full' is not a valid Merge type: left, right, inner, outer, left_anti, right_anti, cross, asofValueError: 'left outer' is not a valid Merge type: left, right, inner, outer, left_anti, right_anti, cross, asof
Cum o eviți pe viitor
- Reține cele cinci valori de bază:
inner,left,right,outer,cross. - După un
mergeimportant, verifică numărul de rânduri și foloseșteindicator=Trueca să vezi de unde vine fiecare rând. - Pentru clienții fără comenzi (sau invers), folosește
indicator=Truesauleft_antiîn pandas 3.
Întrebări frecvente
Care e valoarea implicită pentru how?
inner: păstrează doar rândurile cu cheie în ambele tabele. Dacă după merge „dispar” rânduri, de obicei ai nevoie de left.
Ce face how="cross"?
Combină fiecare rând din stânga cu fiecare rând din dreapta, fără cheie (produs cartezian). Nu primește on, iar rezultatul are len(a) × len(b) rânduri.
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. 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. pandas.errors.MergeError: Can only pass argument "on" OR "left_on" and "right_on", not a combination of both. La merge ai dat și on=, și left_on= / right_on=. Alege una dintre variante: on="id" când cheia are același nume în ambele tabele, sau left_on="id" și right_on="id_client" (ambele) când numele diferă. Î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.
