Disegnare un database, 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 («il risultato non è quello giusto», «PostgreSQL risponde con un errore») dai test.
| Leggi | Vuol dire | Cosa fai |
|---|---|---|
relation "libri" already exists | Rilanci il file e la tabella c'è già: manca il DROP TABLE IF EXISTS in cima | Scrivi DROP TABLE IF EXISTS prestiti, lettori, libri; all'inizio, dalla più figlia alla più madre |
relation "libri2" does not exist (su un REFERENCES) | Hai scritto prima la tabella figlia: punta a una madre che non c'è ancora | Metti i CREATE TABLE in ordine: prima le madri, poi chi le punta. Controlla anche l'ortografia del nome |
cannot drop table libri because other objects depend on it | Cancelli una madre mentre una figlia la punta | Un solo DROP TABLE IF EXISTS con tutte le tabelle, la più figlia per prima |
insert or update on table "prestiti" violates foreign key constraint e Key (libro_id)=(1) is not present in table "libri" | Il libro 1 non c'è: la freccia funziona | Inserisci prima il libro, poi il prestito |
new row for relation "prestiti" violates check constraint "prestiti_check" | Il CHECK ha fermato un dato assurdo (restituito prima del prestito) | Non è un guaio: è il vincolo che fa il suo lavoro. Correggi il dato |
duplicate key value violates unique constraint "interventi_pkey" | La coppia c'è già: la tabella ponte rifiuta il doppione | Un'altra riga non serve: per cambiare le ore, UPDATE |
duplicate key value violates unique constraint "prelievi_carrelli_carrello_id_giorno_preso_alle_key" | Nella storia: hai lanciato livello2.sql due volte sul caso vero | Il foglio è già dentro. Se hai ricaricato panettone.sql ricomincia da livello2.sql, una volta sola |
syntax error at or near ")" in un CREATE TABLE | Una virgola in più dopo l'ultima colonna (o una in meno tra due) | Guarda la riga prima di quella indicata: dopo l'ultima colonna non va la virgola |
es01.sql è ancora vuoto: scrivi la query sotto i commenti e salva il file. | Il test ha trovato solo i commenti (qui «la query» è lo schema) | Scrivi DROP e CREATE TABLE sotto i commenti e salva (Cmd+S, su Windows Ctrl+S) |
La tabella «prestiti» non c'è: il tuo file la crea con questo nome? | Hai scritto prestito o Prestiti: i nomi del contratto vanno rispettati | Rileggi il contratto in alto nel file: nomi e plurali esatti, tutto minuscolo |
nella tabella «righe_ordine» non c'è una colonna «prezzo_pagato» | Hai chiamato la colonna in un altro modo, o la fotografia ti manca | Controlla con \d righe_ordine e il contratto |
AssertionError: assert {} == {'libro_id': ...} (sulle chiavi esterne) | Il test cerca le frecce e chiavi_esterne è vuoto: manca REFERENCES | \d prestiti: sotto Foreign-key constraints devono esserci due righe |
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 (il_ritardo_non_e_negativo, la_mail_e_unica…) |
Il controllo del test: PostgreSQL risponde con un errore | Il test non riesce a inserire dati normali: una colonna che non c'è, un tipo sbagliato, un NOT NULL che non ti aspettavi | Leggi il comando del test e la riga «Vuol dire»: dice di che colonna si tratta |
Gli errori che non danno errori
Il guaio del disegno è questo: PostgreSQL non protesta mai per uno schema sbagliato. Le tabelle si creano, il file gira, e il problema esce mesi dopo. Quattro modi in cui succede.
La chiave esterna senza REFERENCES. libro_id INTEGER NOT NULL sembra una freccia, ma è un numero qualunque. \d prestiti non ha la sezione Foreign-key constraints: è il modo di controllare.
Il NOT NULL di troppo. Una data di restituzione NOT NULL impedisce di registrare un libro appena prestato; la tabella si crea benissimo e il problema è il primo prestito.
La lista in una casella, o il dato copiato. 'metro, tram' in una colonna, o il nome di una stazione scritto in ogni corsa: le query girano e rispondono sbagliato (uno invece di tre, «Porta Codce» tra le stazioni). Se il conteggio non torna, guarda i dati: una virgola dentro un valore, due scritture dello stesso nome.
La fotografia che manca. Un prezzo letto dal listino invece che dall'ordine fa tornare ogni query, e sbaglia l'incasso di ogni mese passato. Ogni volta che un dato «cambia nel tempo», chiediti se la riga deve ricordarsi com'era.
Se il problema non è lo schema
Non riesco a parlare con PostgreSQL, Connection refused, database "sql_disegnare_un_database" does not exist, role "…" does not exist: non è il tuo schema, è l'ambiente. Se PostgreSQL è spento: su WSL sudo service postgresql start, sul Mac brew services start postgresql@16; per il resto c'è il Pronto soccorso. Se pytest non parte o non trova i test: pytest non parte, o non trova niente.