Vai al contenuto
code-to-code

Apro l'indice…

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

Il database nell'API2. psycopgp. 44

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

LeggiVuol direCosa fai
TypeError: query parameters should be a sequence or a mapping, got strHai 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 passedI %s nella query e i valori nella tupla non sono tanti ugualiConta i %s e conta i valori: uno per ogni buco, nello stesso ordine
psycopg.errors.IndeterminateDatatype: could not determine data type of parameter $1Hai messo gli apici intorno al buco: '%s'. Tra apici, il buco non è più un bucoTogli 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 è vuotoAggiungi RETURNING * (o RETURNING id) alla query
KeyError: 0Hai letto una riga con treno[0], ma le righe di questo libro sono dizionaritreno["codice"], con il nome della colonna
TypeError: 'NoneType' object is not subscriptablefetchone() ha dato None (la riga non c'è) e tu sei andato avanti come se l'avesse trovataSubito 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.

LeggiVuol direCosa 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 stringaMai 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 existIl nome della tabella è sbagliato (treno, non treni), oppure il database è vuotoControlla 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 existIl 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 rifiutataCorreggi 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 segnalazioniPrima 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 esisteControlla 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.)

LeggiVuol direCosa fai
database "db_psycopg" does not existPostgreSQL è 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 cartellaPrima 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 refusedHai scritto un host e una porta (o PGHOST=localhost), e lì nessuno risponde: PostgreSQL è spento, o la porta è un'altraAccendi 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_testAccendi 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 caricatepsql -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.