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

pandas.errors.MergeError: Merge keys are not unique in right dataset; not a many-to-one merge

Pe scurt

Ai cerut la merge o verificare (validate="m:1" sau "1:1"), iar tabelul din dreapta are chei repetate, de exemplu același cod de produs de două ori în catalog. Găsește dublurile (df.duplicated("cod", keep=False)) și păstrează un singur rând pe cheie înainte de merge.

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

Ce înseamnă

Parametrul validate îi cere lui merge să verifice relația dintre tabele: "m:1" (many-to-one) = în stânga cheile se pot repeta, în dreapta fiecare cheie apare o singură dată (ca un catalog de produse sau o listă de clienți). Dacă în dreapta o cheie apare de două ori, fiecare comandă cu acea cheie s-ar dubla după merge, iar totalurile ar ieși greșite. Cu validate, pandas oprește operația și îți spune: not a many-to-one merge.

Versiunile noi de pandas afișează sub mesaj și cheile duplicate (Duplicates in right:), deci vezi direct unde e problema. Variantele: not unique in left dataset; not a one-to-many merge și not unique in either left or right dataset; not a one-to-one merge.

Eroarea e o protecție utilă: fără validate, același merge rulează fără niciun mesaj și îți dublează rândurile.

De ce apare: cauzele frecvente

1Catalog cu un produs de două ori

Greșit
PYTHON
linii.merge(produse, on="cod", validate="m:1")
Corect
PYTHON
produse = produse.drop_duplicates("cod", keep="last")
linii.merge(produse, on="cod", validate="m:1")

După eliminarea dublurilor, fiecare cod apare o dată în catalog, iar relația devine many-to-one.

2Cheia nu e suficientă pentru a identifica rândul

Greșit
PYTHON
comenzi.merge(preturi, on="cod", validate="m:1")  # prețuri pe ani
Corect
PYTHON
comenzi.merge(preturi, on=["cod", "an"], validate="m:1")

Dacă tabelul din dreapta are un rând pe (cod, an), cheia trebuie să conțină ambele coloane.

3Dubluri create de diferențe de scriere

Greșit
PYTHON
clienti["email"]   # "Ana@x.ro" și "ana@x.ro "
Corect
PYTHON
clienti["email"] = clienti["email"].str.strip().str.lower()
clienti = clienti.drop_duplicates("email")

Normalizarea cheii face vizibile dublurile reale, care pot fi apoi eliminate.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos dă MergeError: Merge keys are not unique in right dataset. În catalog, produsul P2 apare de două ori (prețul vechi și cel nou, care e ultimul). Păstrează doar ultimul rând pentru fiecare cod, apoi afișează numărul de linii după merge și valoarea totală a comenzilor.

Codul care dă eroarea
PYTHON
import pandas as pd

linii = pd.DataFrame({"cod": ["P1", "P2", "P2", "P3"], "cantitate": [2, 1, 3, 1]})
produse = pd.DataFrame({
    "cod": ["P1", "P2", "P3", "P2"],
    "pret": [10.0, 20.0, 5.0, 25.0],
})

tot = linii.merge(produse, on="cod", how="left", validate="m:1")
tot["valoare"] = tot["cantitate"] * tot["pret"]
print("Linii:", len(tot))
print("Total:", tot["valoare"].sum())
După reparație, programul afișează
Linii: 4
Total: 125.0
Indiciu

produse.drop_duplicates("cod", keep="last") înainte de merge.

Alte forme ale mesajului

  • pandas.errors.MergeError: Merge keys are not unique in either left or right dataset; not a one-to-one merge
  • pandas.errors.MergeError: Merge keys are not unique in left dataset; not a one-to-many merge
  • MergeError: Merge keys are not unique in right dataset; not a many-to-one merge

Cum o eviți pe viitor

  • Pune validate= la fiecare merge important: "m:1" când adaugi informații dintr-un catalog.
  • Verifică cheile înainte: produse["cod"].is_unique sau produse[produse.duplicated("cod", keep=False)].
  • Compară len() înainte și după merge: la un m:1 cu how="left", numărul de rânduri nu trebuie să crească.
  • Decide explicit ce dublură păstrezi (keep="first"/"last", după dată).

Întrebări frecvente

Ce se întâmplă dacă nu pun validate?

Merge-ul rulează și creează câte un rând pentru fiecare combinație de chei egale. O comandă cu un produs care apare de două ori în catalog devine două rânduri, iar sumele se dublează fără niciun avertisment.

Cum văd exact cheile duplicate?

produse[produse.duplicated("cod", keep=False)].sort_values("cod") afișează toate rândurile cu cod repetat, una lângă alta.

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.