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

ValueError: 'outter' is not a valid Merge type: left, right, inner, outer, left_anti, right_anti, cross, asof

Pe scurt

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

Greșit
PYTHON
pd.merge(clienti, comenzi, on="id_client", how="outter")
Corect
PYTHON
pd.merge(clienti, comenzi, on="id_client", how="outer")

outer se scrie cu un singur t.

2Denumiri din SQL

Greșit
PYTHON
pd.merge(a, b, on="id", how="full outer")
pd.merge(a, b, on="id", how="left outer")
Corect
PYTHON
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

Greșit
PYTHON
pd.merge(clienti, comenzi, on="id_client", how="anti")
Corect
PYTHON
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ă tu

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ă.

Codul care dă eroarea
PYTHON
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())
După reparație, programul afișează
5
{'left_only': 2, 'right_only': 1, 'both': 2}
Indiciu

Unirea care păstrează toate rândurile din ambele tabele este how="outer".

Alte forme ale mesajului

  • ValueError: 'full' is not a valid Merge type: left, right, inner, outer, left_anti, right_anti, cross, asof
  • ValueError: '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 merge important, verifică numărul de rânduri și folosește indicator=True ca să vezi de unde vine fiecare rând.
  • Pentru clienții fără comenzi (sau invers), folosește indicator=True sau left_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

← 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.