...
Eroare Python pentru analiza datelor · Coloane, selecție și filtrare

KeyError: 0

Pe scurt

Ai cerut rândul cu eticheta 0 (cu loc sau cu s[0]), dar indexul nu conține 0, de exemplu după o filtrare sau când indexul e format din texte. Pentru „primul rând” folosește poziția: df.iloc[0] sau s.iloc[0]; altfel, resetează indexul cu reset_index(drop=True).

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

Ce înseamnă

În pandas, fiecare rând are o etichetă (indexul) și o poziție (0, 1, 2...). La un DataFrame proaspăt creat cele două coincid, de aceea df.loc[0] pare să însemne „primul rând”. După o filtrare însă, rândurile își păstrează etichetele originale: dacă primul rând care trece filtrul are eticheta 3, nu mai există eticheta 0, iar df.loc[0] dă KeyError: 0.

La fel se întâmplă cu o Series care are ca index texte (de exemplu rezultatul unui groupby sau value_counts): în pandas 3, s[0] caută eticheta 0, nu prima poziție, deci dă KeyError: 0. În versiunile vechi funcționa, cu un avertisment că se va schimba. Tot KeyError: 0 primești și cu df[0], pentru că acolo pandas caută o coloană numită 0.

Regula: loc și parantezele simple lucrează cu etichete, iloc lucrează cu poziții.

De ce apare: cauzele frecvente

1loc[0] după o filtrare

Greșit
PYTHON
scumpe = df[df["pret"] > 100]
print(scumpe.loc[0, "produs"])
Corect
PYTHON
scumpe = df[df["pret"] > 100]
print(scumpe.iloc[0]["produs"])

Filtrarea păstrează etichetele originale ale rândurilor. iloc[0] ia primul rând după poziție, indiferent de etichetă.

2s[0] pe o Series cu index de text

Greșit
PYTHON
pe_oras = df.groupby("oras")["suma"].sum().sort_values(ascending=False)
print(pe_oras[0])
Corect
PYTHON
pe_oras = df.groupby("oras")["suma"].sum().sort_values(ascending=False)
print(pe_oras.iloc[0], pe_oras.index[0])

Indexul sunt numele orașelor, deci eticheta 0 nu există. iloc[0] dă valoarea de pe primul loc, iar index[0] dă numele orașului.

3Renumerotare după filtrare

Greșit
PYTHON
activi = df[df["activ"]]
for i in range(len(activi)):
    print(activi.loc[i, "nume"])
Corect
PYTHON
activi = df[df["activ"]].reset_index(drop=True)
for i in range(len(activi)):
    print(activi.loc[i, "nume"])

reset_index(drop=True) renumerotează rândurile 0, 1, 2..., deci etichetele coincid din nou cu pozițiile.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos filtrează produsele scumpe și vrea să afișeze cel mai scump produs și prețul lui, dar dă KeyError: 0. Repară-l ca să ia primul rând din rezultatul sortat după poziție, nu după etichetă.

Codul care dă eroarea
PYTHON
import pandas as pd

df = pd.DataFrame({
    "produs": ["Mouse", "Laptop", "Cablu", "Monitor", "Tastatură"],
    "pret": [45, 3200, 15, 950, 120],
})

scumpe = df[df["pret"] > 100].sort_values("pret", ascending=False)
primul = scumpe.loc[0]
print(f"Cel mai scump: {primul['produs']} ({primul['pret']} lei)")
print(f"Produse peste 100 lei: {len(scumpe)}")
După reparație, programul afișează
Cel mai scump: Laptop (3200 lei)
Produse peste 100 lei: 3
Indiciu

Primul rând după poziție se ia cu iloc[0].

Alte forme ale mesajului

  • KeyError: 5
  • FutureWarning: Series.__getitem__ treating keys as positions is deprecated. In a future version, integer keys will always be treated as labels (consistent with DataFrame behavior). To access a value by position, use `ser.iloc[pos]`

Cum o eviți pe viitor

  • Când vrei „al n-lea rând”, folosește mereu iloc; când vrei „rândul cu eticheta X”, folosește loc.
  • După filtrări, dacă vrei numerotare de la 0, adaugă reset_index(drop=True).
  • Pentru primul sau ultimul element al unui rezultat sortat, s.iloc[0] și s.index[0] sunt mai clare decât s[0].
  • Evită buclele for i in range(len(df)): de cele mai multe ori o operație pe coloane face același lucru fără indici.

Întrebări frecvente

De ce codul mergea într-o versiune mai veche de pandas?

Până la pandas 2.x, s[0] pe o Series cu index de text era interpretat ca poziție, cu un FutureWarning. În pandas 3, parantezele simple folosesc mereu etichetele, deci același cod dă KeyError: 0. Reparația e s.iloc[0].

Care e diferența între KeyError: 0 și IndexError: single positional indexer is out-of-bounds?

KeyError vine de la loc sau [] și înseamnă „nu există eticheta”. IndexError vine de la iloc și înseamnă „nu există poziția”, de exemplu iloc[10] într-un tabel cu 5 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.