ValueError: Usecols do not match columns, columns expected but not found: ['pret']
Ai cerut la read_csv, prin usecols, o coloană care nu există în antetul fișierului (aici 'pret'). Afișează antetul real (citește fișierul fără usecols și uită-te la df.columns) și scrie în usecols numele exacte, cu aceleași majuscule, spații și diacritice.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
usecols îi spune lui read_csv să păstreze doar anumite coloane. Înainte să citească datele, pandas compară lista ta cu antetul fișierului, iar dacă un nume nu apare acolo, oprește citirea: „columns expected but not found: ['pret']” = coloanele pe care le-ai cerut și nu le-a găsit.
Cauzele sunt aceleași ca la KeyError pe coloană: alt nume în fișier (Pret, pret_unitar, preț), un spațiu după virgula din antet (produs, pret), un separator diferit (;) din cauza căruia tot antetul e o singură coloană.
Dacă dai în usecols poziții ([0, 5]) în loc de nume și o poziție nu există, mesajul e altul: Defining usecols with out-of-bounds indices is not allowed.
De ce apare: cauzele frecvente
1Numele din fișier e diferit
df = pd.read_csv("produse.csv", usecols=["produs", "pret"])
# antetul este: produs,pret_unitar,stocdf = pd.read_csv("produse.csv", usecols=["produs", "pret_unitar"])usecols trebuie să folosească exact numele din antetul fișierului.
2Separator nespecificat
df = pd.read_csv("produse.csv", usecols=["produs", "pret"])
# fișierul folosește ;df = pd.read_csv("produse.csv", sep=";", usecols=["produs", "pret"])Fără sep=";", antetul e citit ca o singură coloană, produs;pret, și niciun nume cerut nu există.
3Spații după virgulă în antet
df = pd.read_csv("produse.csv", usecols=["produs", "pret"])
# antetul este: produs, pretdf = pd.read_csv("produse.csv", skipinitialspace=True, usecols=["produs", "pret"])skipinitialspace=True ignoră spațiile de după separator, deci coloana se numește pret, nu ' pret'.
Repară eroarea, direct în pagină
Codul de mai jos dă ValueError: Usecols do not match columns. Fișierul produse.csv există, dar coloana cu prețul are alt nume. Repară usecols ca să citească produsul și prețul, apoi afișează coloanele citite și prețul mediu.
import pandas as pd
df = pd.read_csv("produse.csv", usecols=["produs", "pret"])
print(df.columns.tolist())
print("Preț mediu:", round(df.iloc[:, 1].mean(), 2))['produs', 'pret_unitar'] Preț mediu: 22.8
Indiciu
Antetul fișierului este produs,pret_unitar,stoc.
Reparația
import pandas as pd
df = pd.read_csv("produse.csv", usecols=["produs", "pret_unitar"])
print(df.columns.tolist())
print("Preț mediu:", round(df.iloc[:, 1].mean(), 2))De ce merge
usecols cerea coloana pret, care nu există în antetul produs,pret_unitar,stoc, așa că read_csv s-a oprit înainte să citească datele. Cu numele real, pret_unitar, pandas păstrează doar cele două coloane cerute, iar media se calculează pe a doua coloană: (24.9 + 12.5 + 31.0) / 3.
Alte forme ale mesajului
ValueError: Usecols do not match columns, columns expected but not found: ['Pret', 'data']pandas.errors.ParserError: Defining usecols with out-of-bounds indices is not allowed. [5] are out of bounds.
Cum o eviți pe viitor
- Citește întâi fișierul fără
usecols(sau doar antetul, cunrows=0) și afișeazădf.columns.tolist(). - Copiază numele coloanelor din antet, nu le scrie din memorie.
- Pentru nume care se schimbă de la un export la altul, poți da o funcție:
usecols=lambda c: c.strip().lower() in {"produs", "pret"}. - Stabilește separatorul înainte de orice altceva.
Întrebări frecvente
Cum văd doar antetul unui fișier mare?
pd.read_csv("fisier.csv", nrows=0).columns.tolist() citește doar prima linie și îți dă lista exactă a coloanelor, fără să încarce datele.
Pot da în usecols numere în loc de nume?
Da: usecols=[0, 2] păstrează prima și a treia coloană. E util când numele sunt instabile, dar fragil dacă ordinea coloanelor se schimbă în fișier.
Erori înrudite
KeyError: 'Pret' DataFrame-ul nu are o coloană cu exact numele 'Pret'. Coloanele sunt sensibile la majuscule, spații și diacritice: afișează print(df.columns.tolist()) și folosește numele exact, de exemplu df["pret"]. ValueError: Missing column provided to 'parse_dates': 'data' Ai cerut la read_csv să transforme în dată (parse_dates) o coloană care nu există în fișier, aici 'data'. Verifică numele exact al coloanei cu datele (df.columns după o citire fără parse_dates) și scrie-l la fel în parse_dates. KeyError: "['email'] not in index" Ai cerut o listă de coloane, iar una dintre ele (aici 'email') nu există în DataFrame, deși celelalte există. Corectează numele din listă după df.columns.tolist() sau creează coloana înainte să o selectezi. Î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.
