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

pandas.errors.MergeError: Can only pass argument "on" OR "left_on" and "right_on", not a combination of both.

Pe scurt

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

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

Ce înseamnă

merge are două feluri de a primi cheia:

  • on="id_client": coloana are același nume în ambele tabele;
  • left_on="id" plus right_on="id_client": coloanele au nume diferite, așa că spui separat numele din stânga și din dreapta.

Când le amesteci, pandas nu știe care e cheia corectă și se oprește. Reversul ei: dacă dai doar left_on fără right_on (sau invers), primești Must pass "right_on" OR "right_index"., adică lipsește jumătatea cealaltă.

O a treia variantă este left_index=True / right_index=True, când cheia stă în indexul unuia dintre tabele.

De ce apare: cauzele frecvente

1on și left_on în același apel

Greșit
PYTHON
pd.merge(comenzi, clienti, on="id_client", left_on="id_client", right_on="id")
Corect
PYTHON
pd.merge(comenzi, clienti, left_on="id_client", right_on="id")

Numele diferă (id_client și id), deci se folosesc doar left_on și right_on.

2Doar o jumătate din pereche

Greșit
PYTHON
pd.merge(comenzi, clienti, left_on="id_client")
Corect
PYTHON
pd.merge(comenzi, clienti, left_on="id_client", right_on="id")

left_on are nevoie mereu de right_on (sau de right_index=True).

3Cheia din dreapta e în index

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

Cu indexul în dreapta, în stânga se folosește left_on, nu on.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos adaugă numele clientului la fiecare comandă. În comenzi cheia se numește id_client, iar în tabelul clienților id, dar apelul amestecă on cu left_on/right_on și dă MergeError: Can only pass argument "on" OR "left_on" and "right_on", not a combination of both.. Repară-l ca să afișeze numele clienților pentru fiecare comandă.

Codul care dă eroarea
PYTHON
import pandas as pd

comenzi = pd.DataFrame({"nr": [10, 11, 12], "id_client": [2, 1, 2]})
clienti = pd.DataFrame({"id": [1, 2], "nume": ["Ana", "Dan"]})

m = pd.merge(comenzi, clienti, on="id_client", left_on="id_client", right_on="id")
print(m[["nr", "nume"]].values.tolist())
După reparație, programul afișează
[[10, 'Dan'], [11, 'Ana'], [12, 'Dan']]
Indiciu

Șterge on= și păstrează doar left_on și right_on.

Alte forme ale mesajului

  • pandas.errors.MergeError: Must pass "right_on" OR "right_index".
  • pandas.errors.MergeError: Must pass "left_on" OR "left_index".

Cum o eviți pe viitor

  • Afișează coloanele ambelor tabele înainte de merge și decide: nume identice → on, nume diferite → left_on + right_on.
  • Sau redenumește cheia într-unul dintre tabele (rename(columns={"id": "id_client"})) și folosește doar on.
  • După unire cu left_on/right_on, ambele coloane cheie rămân în rezultat; șterge-o pe cea în plus cu drop.

Întrebări frecvente

De ce rezultatul are și coloana id, și id_client?

Cu left_on/right_on, pandas păstrează ambele coloane, pentru că au nume diferite. Au aceleași valori pe rândurile unite; șterge una cu .drop(columns="id").

Pot uni după mai multe coloane?

Da, cu liste: on=["oras", "luna"] sau left_on=["oras", "luna"], right_on=["localitate", "luna"]. Listele din stânga și din dreapta trebuie să aibă aceeași lungime.

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.