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

ValueError: columns overlap but no suffix specified: Index(['oras'], dtype='str')

Pe scurt

join a găsit în ambele tabele o coloană cu același nume (aici 'oras') care nu e cheie și nu știe cum să le numească în rezultat. Dă sufixe cu lsuffix și rsuffix, elimină coloana dublă înainte sau folosește merge, care pune singur sufixele _x și _y.

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

Ce înseamnă

stanga.join(dreapta) unește tabelele după index și pune coloanele din dreapta lângă cele din stânga. Dacă o coloană are același nume în ambele, rezultatul ar avea două coloane oras, iar pandas nu acceptă asta fără să îi spui cum să le deosebești. Mesajul îți dă lista coloanelor suprapuse (Index(['oras'], dtype='str')).

merge rezolvă automat situația, adăugând _x și _y, dar join nu are sufixe implicite. Întrebarea reală e: chiar ai nevoie de ambele coloane? Dacă ele conțin aceeași informație, elimin-o pe una înainte de unire; dacă diferă (orașul de livrare și orașul de facturare), dă-le sufixe cu sens.

De ce apare: cauzele frecvente

1Aceeași coloană în ambele tabele

Greșit
PYTHON
t = clienti.join(adrese)   # ambele au "oras"
Corect
PYTHON
t = clienti.join(adrese, lsuffix="_client", rsuffix="_livrare")

Sufixele dau nume diferite celor două coloane: oras_client și oras_livrare.

2Coloana se repetă fără să aducă informație nouă

Greșit
PYTHON
t = clienti.join(adrese)
Corect
PYTHON
t = clienti.join(adrese.drop(columns="oras"))

Dacă orașul e același în ambele tabele, păstrezi o singură coloană.

3Unire după o coloană, nu după index

Greșit
PYTHON
t = comenzi.join(clienti)   # ambele au id_client și nume
Corect
PYTHON
t = comenzi.merge(clienti, on="id_client", suffixes=("_comanda", "_client"))

merge unește după coloana cheie și, pentru coloanele rămase cu același nume, folosește sufixele date (implicit _x și _y).

Repară tu

Repară eroarea, direct în pagină

Ambele tabele sunt indexate după codul clientului și au o coloană oras (orașul din contract și orașul de livrare), iar join dă ValueError: columns overlap but no suffix specified. Repară unirea ca rezultatul să aibă coloanele oras_contract și oras_livrare, apoi afișează clienții la care cele două orașe diferă.

Codul care dă eroarea
PYTHON
import pandas as pd

contracte = pd.DataFrame(
    {"nume": ["Ana Pop", "Ion Toma", "Dan Ilie"], "oras": ["Cluj", "Iași", "Brașov"]},
    index=["C1", "C2", "C3"],
)
livrari = pd.DataFrame(
    {"oras": ["Cluj", "București", "Brașov"]},
    index=["C1", "C2", "C3"],
)

t = contracte.join(livrari)
print(t[t["oras_contract"] != t["oras_livrare"]])
După reparație, programul afișează
        nume oras_contract oras_livrare
C2  Ion Toma          Iași    București
Indiciu

join are parametrii lsuffix și rsuffix.

Alte forme ale mesajului

  • ValueError: columns overlap but no suffix specified: Index(['oras'], dtype='object')
  • ValueError: columns overlap but no suffix specified: Index(['nume', 'oras'], dtype='str')

Cum o eviți pe viitor

  • Înainte de join, verifică coloanele comune: stanga.columns.intersection(dreapta.columns).
  • Elimină coloanele care se repetă fără motiv sau dă-le sufixe cu sens.
  • Pentru unire după coloane, folosește merge; păstrează join pentru tabele indexate după aceeași cheie.
  • Alege sufixe care spun ce înseamnă fiecare coloană (_contract, _livrare), nu _x și _y.

Întrebări frecvente

Care e diferența între join și merge?

join unește implicit după index și nu are sufixe implicite. merge unește după coloane (sau după index, dacă îi spui) și pune automat _x și _y la coloanele cu același nume. Pentru aceeași operație, poți folosi oricare.

Pot pune sufix doar pe un tabel?

Da: lsuffix="" și rsuffix="_nou" păstrează numele original pentru stânga și pune sufixul doar pe coloana din dreapta.

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.