Vai al contenuto
code-to-code

Apro l'indice…

↑ ↓ per scegliere, Invio per aprire, Esc per chiudere

Il database nell'API4. SQLAlchemy: le tabelle diventano classip. 96

SQLAlchemy: se qualcosa va storto

Gli errori delle classi-tabella, uno per uno

Questo è il capitolo dove molti si bloccano: i nomi si assomigliano (TrenoDB, Treno, TrenoNuovo), gli errori hanno nomi lunghi, e il database sta dietro un altro strato. Niente panico: quasi tutti gli errori sono questi. Ognuno qui sotto è stato provato davvero.

Ricorda come si legge un errore: dal basso. L'ultima riga dice cosa; il resto dice dove. Tutto è nel capitolo Leggere un traceback.

Gli errori delle classi

LeggiVuol direCosa fai
TypeError: 'carrozze' is an invalid keyword argument for TrenoDBHai dato al costruttore un nome che non è una colonna della classeGuarda modelli.py: i nomi validi sono quelli degli attributi. Un refuso? carrozze per vagoni?
AttributeError: type object 'TrenoDB' has no attribute 'codici'Hai scritto male il nome di una colonna (qui codici invece di codice)Ricopia il nome da modelli.py. VS Code te lo suggerisce se scrivi TrenoDB. e aspetti
ArgumentError: Column expression, FROM clause, or other columns clause element expected, got <class 'stampi.Treno'>.Hai messo uno stampo in select(...). select vuole una classe-tabellaselect(TrenoDB), con DB
NoInspectionAvailable: No inspection system is available for object of type <class 'pydantic._internal._model_construction.ModelMetaclass'>Hai dato uno stampo a un'operazione della sessione (qui db.get(Treno, 1)). La sessione vuole una classe-tabelladb.get(TrenoDB, 1)
FastAPIError: Invalid args for response field! Hint: check that <class 'modelli.TrenoDB'> is a valid Pydantic field type.Nella freccia della rotta hai scritto -> TrenoDB. La risposta è uno stampo: FastAPI si ferma già all'avvio-> Treno. Nelle frecce e nei parametri, gli stampi
ValidationError ... Input should be a valid dictionary or instance of TrenoNuovoHai riempito con model_validate uno stampo che non ha from_attributes, partendo da un oggettoUsa lo stampo della risposta (Treno), che ha model_config = ConfigDict(from_attributes=True)

La freccia -> TrenoDB e il select(Treno) sono lo stesso sbaglio in due posti: una classe di un mondo dove ne serve una dell'altro. Quando non sai quale, chiediti: parla Pydantic (che controlla i dati) o parla il database? Nel primo caso uno stampo, nel secondo la classe con DB.

Gli errori della classe che non coincide con la tabella

LeggiVuol direCosa fai
ArgumentError: Mapper Mapper[PannelloDB(pannelli)] could not assemble any primary key columns for mapped table 'pannelli'La classe non ha nessuna colonna con primary_key=TrueUna colonna con mapped_column(primary_key=True): di solito id
InvalidRequestError: Class ... does not have a __table__ or __tablename__ specified and does not inherit from an existing table-mapped class.Manca __tablename__Aggiungi __tablename__ = "nome_della_tabella"
NoReferencedTableError: Foreign key associated with column 'pannelli.stazione_id' could not find table 'stazione' ...ForeignKey("stazione.id") punta a una tabella che non esiste: la tabella si chiama stazioniIl nome è quello di __tablename__: ForeignKey("stazioni.id")
ProgrammingError: (psycopg.errors.UndefinedColumn) column treni.colore does not existLa classe ha una colonna (colore) che nel database non c'è. Comanda il databaseO togli la colonna dalla classe, o la aggiungi alla tabella con SQL (ALTER TABLE). La classe non cambia la tabella

L'ultimo è la lezione del capitolo: la classe descrive, il database comanda. Se la classe dice una cosa e il database un'altra, l'errore compare solo quando fai la domanda: SQLAlchemy scrive SELECT treni.id, treni.codice, treni.colore e PostgreSQL risponde che colore non esiste. Con echo=True vedi proprio quella riga.

Gli errori della strada (l'engine)

LeggiVuol direCosa fai
NoSuchModuleError: Can't load plugin: sqlalchemy.dialects:postgresNell'indirizzo hai scritto postgres://. Il nome del database per SQLAlchemy è postgresqlpostgresql+psycopg:///nome_del_database
OperationalError: (psycopg.OperationalError) connection failed: ... FATAL: database "db_che_non_esiste" does not existIl database con quel nome non c'è. Il nome sbagliato (o la variabile MENTA_DB)createdb db_sqlalchemy, poi psql -d db_sqlalchemy -f linea_menta.sql. Controlla il nome in database.py
PostgreSQL non risponde, quindi i test non possono partire.PostgreSQL è spento, o psycopg non trova il socket. Il resto del messaggio dice quale dei due: connection failed: ... No such file or directoryMac: brew services start postgresql@16. WSL: sudo service postgresql start. Se è acceso: export PGHOST=/tmp (Mac) o export PGHOST=/var/run/postgresql (WSL)
ModuleNotFoundError: No module named 'modelli'Hai lanciato un file che sta fuori da palestra/: Python cerca modelli.py accanto al fileMetti il tuo file dentro palestra/ e lancia python palestra/prova.py
ModuleNotFoundError: No module named 'sqlalchemy'Il venv è spento, o manca pip installsource .venv/bin/activate, poi pip install -r requirements.txt

Il terminale che scrive troppo

Con echo=True ogni query riempie il terminale. È voluto: è lo strumento per vedere cosa fa SQLAlchemy. Le prime tre domande dopo l'avvio (select pg_catalog.version(), select current_schema(), show standard_conforming_strings) le fa una volta sola, per scoprire che database ha davanti: sono normali.

Per capire un errore, parti dall'ultima riga di traceback e dalle righe INFO ... Engine subito prima: l'ultima query scritta è quella che ha fatto storcere il naso al database.

Errori che non danno errori

Qualche confusione non fa fermare niente.

km che resta None. Crei TrenoDB(codice="M30", vagoni=5, in_servizio=True) e pensi che km valga 0 perché il database ha DEFAULT 0. Per l'oggetto, finché non è salvato, km è None.

Il refuso in un test della palestra. Se una risposta in risposte.py ha lo stesso valore ma con il tipo sbagliato ("6" invece di 6), il test dice solo «non è quello che c'è nel modello». Guarda se hai messo le virgolette dove non servono.

I tre puntini. Manca la risposta: al posto dei tre puntini (...) scrivi la tua. Non è un errore del modello: c'è ancora il segnaposto ... in risposte.py.

Se il problema non è il codice

pytest: command not found, No module named pytest, il pannello Testing vuoto: non è il tuo codice, è l'ambiente. Ha una pagina sua nel Pronto soccorso: pytest non parte, o non trova niente.