...
Eroare Python pentru analiza datelor · Crearea unui DataFrame

ValueError: DataFrame constructor not properly called!

Pe scurt

pd.DataFrame() a primit un singur text sau un singur număr, nu un tabel. Cel mai des îi dai textul unui JSON sau numele unui fișier. Transformă textul în date cu json.loads() sau pd.read_json(), iar fișierele le citești cu pd.read_csv().

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

Ce înseamnă

pd.DataFrame(...) construiește un tabel din ceva care are deja formă de tabel: un dicționar de liste, o listă de dicționare, o listă de liste, un array NumPy, o serie. Dacă îi dai un scalar (un text, un număr, None în unele contexte), pandas nu are din ce să facă rânduri și coloane și se oprește cu mesajul acesta.

Cel mai des se întâmplă în două situații: ai primit un răspuns JSON de la un API ca text (str) și l-ai dat direct la pd.DataFrame, sau ai scris numele fișierului (pd.DataFrame("vanzari.csv")) crezând că pandas îl citește.

Ca să găsești cauza, uită-te la linia din eroare și afișează tipul argumentului cu print(type(x)). Dacă vezi <class 'str'>, ai un text, nu date.

De ce apare: cauzele frecvente

1Textul unui JSON dat direct la DataFrame

Greșit
PYTHON
raspuns = '[{"produs": "Cafea", "pret": 24.5}]'
df = pd.DataFrame(raspuns)
Corect
PYTHON
import json
raspuns = '[{"produs": "Cafea", "pret": 24.5}]'
df = pd.DataFrame(json.loads(raspuns))

raspuns e un singur text. json.loads îl transformă într-o listă de dicționare, iar din lista asta pandas face rânduri.

2Numele fișierului în loc de citirea lui

Greșit
PYTHON
df = pd.DataFrame("vanzari.csv")
Corect
PYTHON
df = pd.read_csv("vanzari.csv")

pd.DataFrame nu deschide fișiere. Pentru fișiere folosești funcțiile read_*: read_csv, read_excel, read_json.

3Un singur număr în loc de o listă

Greșit
PYTHON
total = df["suma"].sum()
rezumat = pd.DataFrame(total)
Corect
PYTHON
total = df["suma"].sum()
rezumat = pd.DataFrame({"total": [total]})

Un număr singur nu e tabel. Pune-l într-un dicționar cu o listă, ca să ai o coloană cu un rând.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos primește lista de produse ca text JSON (așa cum vine de la un API) și dă ValueError: DataFrame constructor not properly called!. Repară-l ca să construiască tabelul și să afișeze numărul de rânduri și coloane, apoi suma prețurilor.

Codul care dă eroarea
PYTHON
import json
import pandas as pd

raspuns = '[{"produs": "Cafea", "pret": 24.5}, {"produs": "Ceai", "pret": 12.0}, {"produs": "Miere", "pret": 31.5}]'

df = pd.DataFrame(raspuns)
print(df.shape)
print(df["pret"].sum())
După reparație, programul afișează
(3, 2)
68.0
Indiciu

Transformă întâi textul în listă de dicționare cu json.loads.

Cum o eviți pe viitor

  • Înainte de pd.DataFrame(x), verifică cu type(x) că ai o listă, un dicționar sau un array, nu un text.
  • Răspunsurile de la API-uri vin ca text: folosește response.json() sau json.loads() înainte să construiești tabelul.
  • Pentru fișiere folosește mereu pd.read_csv, pd.read_excel, pd.read_json.
  • O valoare singură o pui în listă: {"total": [valoare]}.

Întrebări frecvente

De ce pd.DataFrame(5) nu face un tabel cu un rând?

Pentru că pandas nu știe ce nume să dea coloanei și câte rânduri să facă. Îi spui explicit: pd.DataFrame({"valoare": [5]}).

Pot folosi pd.read_json direct pe text?

Da, dar în pandas recent textul trebuie împachetat în io.StringIO(text): pd.read_json(io.StringIO(text)). Varianta cu json.loads și pd.DataFrame merge la fel de bine pentru o listă de obiecte.

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.