Leggere, se qualcosa va storto
Gli errori di PostgreSQL e le risposte che sembrano giuste
Gli errori che vedrai di più in questo capitolo. Per ognuno: cosa leggi, cosa vuol dire, cosa fai.
PostgreSQL scrive l'errore in tre pezzi: la riga ERROR: che dice cosa, la riga LINE 1: con la tua query, e sotto un ^ che indica dove si è fermato. Guarda sempre il ^: l'errore è lì, o appena prima.
| Leggi | Vuol dire | Cosa fai |
|---|---|---|
syntax error at or near "WHERE" | Una parola è fuori posto: qui un WHERE dopo l'ORDER BY | L'ordine è fisso: SELECT, FROM, WHERE, ORDER BY, LIMIT. Rimetti a posto |
syntax error at or near ";" | La query finisce a metà: un OR, un AND o un IS NOT senza niente dopo | Completa la condizione |
syntax error at or near "avventura" | Un apostrofo dentro un testo ha chiuso il testo prima del tempo | Raddoppialo: 'Libro d''avventura' |
column "metro" does not exist | Un testo senza apici (o con le virgolette doppie): PostgreSQL lo cerca come colonna | Apici singoli: 'metro' |
column "vagon" does not exist | Hai sbagliato il nome di una colonna. Spesso c'è un HINT: che dice quale volevi | Controlla con \d treni nel prompt di psql |
relation "treno" does not exist | Hai sbagliato il nome della tabella, oppure sei nel database sbagliato | \dt per l'elenco; \c ti dice dove sei: il prompt mostra il nome del database |
operator does not exist: date = integer | Una data senza apici: 2026-11-17 è una sottrazione | '2026-11-17' |
operator does not exist: text == unknown | Hai scritto == come in Python | In SQL il confronto è =, uno solo |
invalid input syntax for type integer: "sei" | Hai confrontato un numero con un testo | Un numero non vuole apici: vagoni = 6 |
il prompt diventa sql_leggere-# | psql aspetta il punto e virgola | Scrivi ; e Invio (o Ctrl+C per ricominciare) |
Gli errori che non danno errori
I più difficili sono quelli senza messaggio: la query gira, il risultato è sbagliato, il test è rosso. In questo capitolo sono quasi sempre uno di questi.
(0 rows). Una risposta vuota può essere vera, o può nascondere un errore. I colpevoli abituali: = NULL al posto di IS NULL; un LIKE con = (ruolo = 'capo%'); un testo scritto un po' diverso ('Libro davventura'); un AND dove volevi un OR. Prima di fidarti di un risultato vuoto, prova la stessa query senza il pezzo sospetto e guarda cosa cambia.
Troppe righe. Quasi sempre un OR senza parentesi: AND lega prima, e metà della condizione si perde. Metti le parentesi.
Mancano righe. Tre sospetti: > al posto di >= (l'estremo resta fuori), LIKE al posto di ILIKE (le maiuscole), e un NULL che un confronto come <> 0 lascia da parte.
Il nome della colonna cambia. Se dimentichi una virgola, SELECT codice vagoni FROM treni non dà errore: PostgreSQL legge vagoni come un AS implicito e ti ridà la colonna codice con il nome sbagliato. Se una colonna che hai chiesto non compare, controlla le virgole.
vagoni
--------
M14
M12
...Le righe sono giuste ma in un altro ordine. Manca l'ORDER BY, oppure manca il DESC. Senza ORDER BY il database non promette un ordine.
LIMIT 3 dà tre righe sbagliate. Manca l'ORDER BY prima del LIMIT, oppure con DESC in testa vengono i NULL: aggiungi WHERE colonna IS NOT NULL.
Se il problema non è la query
pytest: command not found, Non riesco a parlare con PostgreSQL, Connection refused, database "sql_leggere" does not exist: non è la query, è l'ambiente (venv spento, PostgreSQL spento, database da creare). Le uscite sono nella tabella del README.md dello zip e in PostgreSQL e psql. Il caso più comune, il venv che non è acceso, ha una pagina sua nel Pronto soccorso: pytest non parte, o non trova niente.