Gli attributi, se qualcosa va storto
Gli errori di PostgreSQL e i test rossi
Gli errori che vedrai di più in questo capitolo. Per ognuno: cosa leggi, cosa vuol dire, cosa fai. Quelli di PostgreSQL arrivano da psql -f; quelli in italiano («PostgreSQL risponde con un errore», «Vuol dire: …») e le righe assert arrivano dai test.
| Leggi | Vuol dire | Cosa fai |
|---|---|---|
new row for relation "oggetti" violates check constraint "oggetti_categoria_check" | Hai scritto un valore che non è nella lista del CHECK (per esempio 'ombrello' invece di 'ombrelli') | Non è un guaio: è il vincolo che lavora. Scrivi uno dei valori ammessi, con le lettere esatte |
null value in column "descrizione" of relation "oggetti" violates not-null constraint | Manca un valore in una colonna NOT NULL | Scrivilo. Se non può esistere sempre, chiediti se la colonna deve essere facoltativa, e cosa vuol dire il vuoto |
duplicate key value violates unique constraint "addetti_email_key" | Quel valore c'è già e la colonna è UNIQUE | Cambia il dato, oppure usa la riga che c'è già |
new row for relation "restituzioni" violates check constraint "restituzioni_documento_finale_check" | Il valore non ha la lunghezza che il CHECK vuole (qui: quattro caratteri) | Scrivi solo le ultime quattro cifre: il documento intero non serve |
relation "oggetti" already exists | Rilanci il file e la tabella c'è già | Cancella le tabelle in cima al file (DROP TABLE IF EXISTS, dalla più figlia alla più madre) oppure, se è il tuo database di prova, dropdb e createdb |
syntax error at or near ")" in un CREATE TABLE | Una virgola dopo l'ultima colonna, o una che manca tra due | Guarda la riga prima di quella indicata |
numeric field overflow | Il numero non sta in NUMERIC(p,s): con NUMERIC(4,2) il massimo è 99,99 | Allarga il tipo (NUMERIC(6,2)), se il valore è giusto |
invalid input syntax for type date: "..." oppure date/time field value out of range | La data non è scritta come '2026-11-19' (anno-mese-giorno, tra apici) | Riscrivila così |
Non riesco a parlare con PostgreSQL | PostgreSQL è spento | WSL: sudo service postgresql start · Mac: brew services start postgresql@16 |
es01.sql è ancora vuoto: scrivi la query sotto i commenti e salva il file. | Il test ha trovato solo i commenti | Scrivi DROP e CREATE TABLE sotto i commenti e salva (Cmd+S, su Windows Ctrl+S) |
La tabella «visite» non c'è: il tuo file la crea con questo nome? | Hai scritto visita o Visite: i nomi del contratto vanno rispettati | Rileggi il contratto in alto nel file: nomi e plurali esatti, tutto minuscolo |
nella tabella «pazienti» non c'è una colonna «nato_il» | Hai chiamato la colonna in un altro modo | \d pazienti e il contratto: i nomi devono combaciare |
assert 'real' == 'numeric(6,2)' (o simili) su colonne(...) | Il tipo della colonna non è quello del contratto | \d nome_tabella mostra il tipo: i soldi sono NUMERIC(6,2), le date DATE, data e ora TIMESTAMP |
assert False su respinta(...) | Il test ha provato a scrivere una cosa sbagliata e il database l'ha accettata: manca un vincolo | Leggi il nome del test: dice quale (la_specie_e_una_delle_quattro, il_peso_e_maggiore_di_zero…) |
assert not respinta(...) rosso | Il test ha provato a scrivere una cosa giusta e il database l'ha rifiutata: un vincolo di troppo (spesso un NOT NULL o un CHECK troppo stretto) | Guarda cosa il test provava a scrivere e quale vincolo lo ferma |
l'età cambia ogni anno: si calcola da nato_il e simili (nei messaggi dei test) | Hai salvato un dato che si può calcolare | Togli la colonna: si ricalcola con una query quando serve |
Il controllo del test: PostgreSQL risponde con un errore | Il test non riesce a scrivere dati normali: una colonna che non c'è, un NOT NULL che non ti aspettavi | Leggi il comando del test e la riga «Vuol dire» |
Gli errori che non danno errori
In questo capitolo il guaio più grande è che PostgreSQL non protesta mai per uno schema sbagliato. Le tabelle si creano, il file gira, e il problema esce mesi dopo. Cinque modi.
Un NULL di troppo. Ogni colonna lasciata senza NOT NULL accetta il vuoto. Una riga con il solo id e il resto vuoto è una riga valida. Se i tuoi conteggi hanno righe fantasma, guarda i NULL.
Il vuoto che sfugge a <>. WHERE colore <> 'blu' non trova le righe senza colore. Non ricevi nessun errore: ricevi una riga in meno. Se la colonna è facoltativa, la domanda «non è blu» ha bisogno di OR colore IS NULL.
Il testo con dentro un numero. Un CAP o un telefono come INTEGER perdono lo zero iniziale e nessuno se ne accorge. Dove non fai conti, usa TEXT.
Il dato salvato che invecchia. Un'età, un «da quanti giorni», un «in ritardo», un totale: la colonna è giusta il giorno in cui la scrivi e sbagliata quello dopo. Se i numeri della scheda non tornano con la realtà, cerca una colonna che dovresti calcolare.
Il CHECK che non protegge. Un CHECK (anno BETWEEN 1450 AND 2100) lascia passare l'anno vuoto, e un CHECK scritto sulla colonna sbagliata non dà errori. Prova sempre a scrivere nel database un valore sbagliato e a guardare se lo rifiuta: è quello che fanno i test.
Se il problema non è lo schema
Connection refused, database "progetto_gli_attributi" does not exist, role "…" does not exist: non è il tuo schema, è l'ambiente. Per il resto c'è il Pronto soccorso. Se pytest non parte o non trova i test: pytest non parte, o non trova niente.