psycopg, se qualcosa va storto
Gli errori di psycopg, uno per uno
Gli errori che vedrai di più in questo capitolo. Per ognuno: cosa leggi, cosa vuol dire, cosa fai. Sono stati tutti provati davvero, con psycopg 3.3 e PostgreSQL 16, e i messaggi qui sotto sono copiati dall'output.
Ricorda come si legge un traceback: dal basso. L'ultima riga dice cosa. Con psycopg il traceback è lungo, perché passa per molti file della libreria: tu cerca la prima riga che nomina un tuo file (palestra/…), e poi leggi la riga sopra l'ultima. Tutto il metodo è in Leggere un traceback.
Quando sbagli il Python: i valori e i buchi
| Leggi | Vuol dire | Cosa fai |
|---|---|---|
TypeError: query parameters should be a sequence or a mapping, got str | Hai passato (codice) e non (codice,): le parentesi da sole non fanno la tupla, è la virgola | (codice,) |
TypeError: object of type 'int' has no len() | Hai passato un numero nudo, senza tupla: execute(query, 3) | (3,) |
psycopg.ProgrammingError: the query has 2 placeholders but 1 parameters were passed | I %s nella query e i valori nella tupla non sono tanti uguali | Conta i %s e conta i valori: uno per ogni buco, nello stesso ordine |
psycopg.errors.IndeterminateDatatype: could not determine data type of parameter $1 | Hai messo gli apici intorno al buco: '%s'. Tra apici, il buco non è più un buco | Togli gli apici: %s. Il tipo lo decide psycopg |
psycopg.ProgrammingError: the last operation didn't produce records (command status: INSERT 0 1) | Hai fatto fetchone() o fetchall() dopo una scrittura senza RETURNING: il vassoio è vuoto | Aggiungi RETURNING * (o RETURNING id) alla query |
KeyError: 0 | Hai letto una riga con treno[0], ma le righe di questo libro sono dizionari | treno["codice"], con il nome della colonna |
TypeError: 'NoneType' object is not subscriptable | fetchone() ha dato None (la riga non c'è) e tu sei andato avanti come se l'avesse trovata | Subito dopo il fetchone(): if treno is None: e decidi cosa fare |
La seconda e la terza riga sono sorelle. Con un solo %s e un numero nudo, il messaggio nomina len(); con una stringa nuda, nomina str.
Quando sbagli il SQL: l'errore viene dal database
Questi errori hanno tutti una struttura: il nome dell'errore (psycopg.errors.QualcosaViolation), poi una frase del database, poi una riga DETAIL: che ti dice quale riga ha dato fastidio. Non li ha scritti psycopg: li ha scritti PostgreSQL, e arrivano in inglese per tutti.
| Leggi | Vuol dire | Cosa fai |
|---|---|---|
psycopg.errors.SyntaxError: syntax error at or near "Alessio" | La query non è SQL valido. Se c'è un nome con un apostrofo (Gino D'Alessio) l'hai incollato dentro una f-string: l'apostrofo ha chiuso la stringa | Mai valori dentro la stringa: %s e la tupla. Il messaggio ha anche una freccia ^ che indica il punto |
psycopg.errors.UndefinedTable: relation "treno" does not exist | Il nome della tabella è sbagliato (treno, non treni), oppure il database è vuoto | Controlla il nome con psql -d db_psycopg -c "\dt". Se è vuoto: psql -d db_psycopg -f linea_menta.sql |
psycopg.errors.UndefinedColumn: column "codice_treno" does not exist | Il nome della colonna è sbagliato | \d treni in psql ti elenca le colonne vere |
psycopg.errors.CheckViolation: new row for relation "treni" violates check constraint "treni_vagoni_check" | Un valore rompe un vincolo CHECK (qui: vagoni deve essere maggiore di zero). Il DETAIL mostra la riga rifiutata | Correggi il valore. Se l'errore è giusto, gestiscilo con try/except |
psycopg.errors.UniqueViolation: duplicate key value violates unique constraint "treni_codice_key", DETAIL: Key (codice)=(M12) already exists. | Hai scritto un valore che doveva essere unico, e c'è già (qui un codice treno) | Scegli un altro valore, o cerca prima quello che c'è |
psycopg.errors.ForeignKeyViolation: update or delete on table "treni" violates foreign key constraint "segnalazioni_treno_id_fkey" on table "segnalazioni", DETAIL: Key (id)=(2) is still referenced from table "segnalazioni". | Stai cancellando una riga che un'altra tabella usa ancora: il M12 ha delle segnalazioni | Prima togli (o sposta) le righe che la usano. Nel capitolo dopo diventa un 409 |
psycopg.errors.ForeignKeyViolation: insert or update on table "treni" violates foreign key constraint "treni_stazione_id_fkey", DETAIL: Key (stazione_id)=(42) is not present in table "stazioni". | Stai scrivendo un riferimento a una riga che non c'è: la stazione 42 non esiste | Controlla il numero. Il vincolo ti sta salvando da un dato rotto |
I nomi dei vincoli (treni_vagoni_check, treni_codice_key) li ha dati PostgreSQL, dalla tabella e dalla colonna. Sono nel DETAIL e nella frase: leggili, ti dicono dove guardare.
Quando un'istruzione del with dà un'errore, tutto il blocco viene annullato, anche le scritture precedenti. Lo hai visto negli esercizi spiegati, esempio D: è un comportamento voluto.
Quando non riesce a collegarsi
Questi sono psycopg.OperationalError: l'errore non è nella tua query, è nella strada. Provati cambiando una variabile d'ambiente alla volta.
$ MENTA_DB=db_che_non_esiste python palestra/prova.py
Errore: connection failed: connection to server on socket "/tmp/.s.PGSQL.5432" failed: FATAL: database "db_che_non_esiste" does not exist
$ PGHOST=/non/esiste python palestra/prova.py
Errore: connection is bad: connection to server on socket "/non/esiste/.s.PGSQL.5432" failed: No such file or directory
Is the server running locally and accepting connections on that socket?
$ PGHOST=localhost PGPORT=5999 python palestra/prova.py
Errore: connection failed: connection to server at "127.0.0.1", port 5999 failed: could not receive data from server: Connection refused
Multiple connection attempts failed. All failures were:
…(Nell'ultimo ho tolto le righe che ripetono lo stesso errore, una per ogni indirizzo provato.)
| Leggi | Vuol dire | Cosa fai |
|---|---|---|
database "db_psycopg" does not exist | PostgreSQL è acceso, ma il database non l'hai ancora creato (o il nome è scritto male: MENTA_DB sbagliata?) | createdb db_psycopg, poi psql -d db_psycopg -f linea_menta.sql |
No such file or directory … Is the server running locally and accepting connections on that socket? | psycopg cerca PostgreSQL nel socket, e il file del socket non c'è: o PostgreSQL è spento, o sta in un'altra cartella | Prima accendi PostgreSQL: Mac brew services start postgresql@16, WSL sudo service postgresql start. Poi, se persiste, dì a psycopg dove cercare: Mac export PGHOST=/tmp, WSL export PGHOST=/var/run/postgresql |
Connection refused | Hai scritto un host e una porta (o PGHOST=localhost), e lì nessuno risponde: PostgreSQL è spento, o la porta è un'altra | Accendi PostgreSQL. In questo libro non serve nessun host: se hai un PGHOST impostato per sbaglio, unset PGHOST |
PostgreSQL non risponde, quindi i test non possono partire. | Lo dice conftest.py: PostgreSQL è spento, e i test non possono creare il database db_psycopg_test | Accendi PostgreSQL (vedi sopra), poi rilancia pytest |
relation "treni" does not exist, e il database c'è | Il database c'è ma è vuoto: le tabelle non sono state caricate | psql -d db_psycopg -f linea_menta.sql |
Quando i test sono rossi, e il programma «funziona»
Gli errori che non danno errori sono i più difficili: il programma gira, il database risponde, ma il test è rosso, o peggio, è verde e il bug c'è. In questo capitolo sono quasi sempre uno di questi.
La scrittura che non si salva. Il programma stampa il risultato giusto, ma guardando nel database la riga non c'è, o il valore è quello vecchio. Quasi sempre manca il with: hai scritto conn = connetti() e nessuno ha fatto il commit. Controlla con psql, come nell'esempio C degli esercizi spiegati, e poi cerca nel codice la riga with connetti() as conn:.
La metà di una coppia. Due scritture che vanno insieme (il treno fuori servizio e la sua segnalazione) in due with diversi: la prima fa commit, e se la seconda fallisce resta mezzo lavoro. Se due scritture sono una cosa sola, stanno dentro lo stesso with.
Il test passa solo per i nomi tranquilli. La funzione usa una f-string: con Lucia Ferri va tutto bene, con Gino D'Alessio si rompe, con x' OR '1'='1 trova tutti. Cerca nella query le graffe { dentro una stringa SQL: sono il segnale.
Il test di prima rovina quello di dopo. Non succede, e non cercarlo: prima di ogni test il database dei test torna come nuovo. Se un test dipende dall'ordine in cui sono lanciati, è il test (o il tuo db_psycopg) a essere sbagliato, non il database dei test.
Il database dei test non risponde. Se pytest si ferma dopo qualche secondo con un errore che nomina lock timeout o canceling statement due to lock timeout, qualcuno tiene ancora aperta una connessione al database dei test: un altro terminale con pytest in corso, o un programma che non hai chiuso. Chiudilo, e rilancia.
Per trovare dove un valore diventa quello sbagliato, il debugger: un breakpoint prima dell'execute, e in WATCH la query e la tupla che stai per mandare. Come si fa: Il debugger, passo per passo.
Se il problema non è il codice
pytest: command not found, No module named 'psycopg', il pannello Testing vuoto, No module named 'persona_per_badge': non è il tuo codice, è l'ambiente (il venv spento, o pip install mai fatto, o un terminale aperto nella cartella sbagliata). È il caso più comune di tutto il sito, e ha una pagina sua nel Pronto soccorso: pytest non parte, o non trova niente. Per tutto il resto: Pronto soccorso.