PostgreSQL e psql, se qualcosa va storto
Gli errori di psql, uno per uno
Gli errori che vedrai di più con PostgreSQL. Per ognuno: cosa leggi, cosa vuol dire, cosa fai.
Prima di tutto, sempre la stessa domanda: il server è acceso? pg_isready risponde in un secondo. E leggi il messaggio fino in fondo: la parte che conta è dopo FATAL: o ERROR:.
| Leggi | Vuol dire | Cosa fai |
|---|---|---|
connection to server on socket "…" failed: No such file or directory | psql non trova il socket: il server è spento, oppure psql cerca nella cartella sbagliata | Guarda il percorso tra le virgolette. È quello giusto (Mac /tmp, WSL /var/run/postgresql)? Allora accendi il server. Se no, export PGHOST=/tmp (Mac) o export PGHOST=/var/run/postgresql (WSL) |
Connection refused (con localhost e una porta) | psql è passato dalla rete e non ha trovato il server: è spento | Mac: brew services start postgresql@16. WSL: sudo service postgresql start. Poi pg_isready |
pg_isready risponde no response | Spento, o cerca nella cartella sbagliata | Leggi il percorso prima dei due punti, come sopra |
FATAL: database "marta" does not exist (il nome è il tuo utente) | Hai scritto psql senza -d: prova a entrare in un database con il tuo nome | psql -d nome_del_database |
FATAL: database "nome" does not exist | Il database non c'è: nome sbagliato, o non lo hai ancora creato | psql -l per vedere quali ci sono. Poi createdb nome e psql -d nome -f file.sql |
createdb: error: … already exists | Il database c'è già | Entraci con psql -d nome. Per ripartire da zero: prima dropdb nome |
dropdb: error: … does not exist | Hai sbagliato il nome, o l'hai già cancellato | psql -l: copia il nome da lì |
dropdb: error: … is being accessed by other users | C'è ancora una sessione aperta su quel database: un altro psql, o VS Code | Esci con \q dagli altri terminali, chiudi la connessione in VS Code, riprova |
FATAL: role "nome" does not exist | L'utente che stai usando non esiste nel server | WSL: sudo -u postgres createuser --superuser "$USER". Se hai scritto -U nome a mano, toglilo |
password authentication failed | Stai passando dalla rete (host=localhost), e lì la password serve | Con psql non scrivere l'host: usa il socket. In VS Code, la password che hai impostato con ALTER USER |
psql: error: menta.sql: No such file or directory | psql -f non trova il file: percorso o nome sbagliato | ls per vedere dove sei e cosa c'è. Nelle missioni, il file sta due cartelle più su: ../../menta.sql |
Il prompt è nome-# e non succede niente | Non hai messo il punto e virgola: psql aspetta il resto | Scrivi ; e Invio. Se non vuoi più quel comando, Ctrl+C |
Did not find any relations. | Il database c'è ma è vuoto, oppure sei in un altro database | Controlla il prompt: sei dove credi? \c nome per spostarti. Se è vuoto, carica menta.sql |
ERROR: relation "turno" does not exist | La tabella non c'è: nome sbagliato (qui manca la i), o database vuoto | \dt per vedere i nomi veri |
PostgreSQL non risponde. È acceso? (da prepara.sh) | Lo script non riesce a parlare con il server | Accendilo, poi rilancia bash prepara.sh |
Gli errori che non danno errori
Il database sbagliato. Hai caricato menta.sql nel database giusto, ma il test guarda quello con il nome della missione. Leggi il nome nel README.md della missione e guarda il prompt di psql: se dice un altro nome, sei altrove.
Ricaricato e perso. menta.sql cancella le sue tabelle e le rifà. Se in quel database avevi aggiunto qualcosa tu, è sparito. Il file è fatto per questo, ma è meglio saperlo prima.
Il nome troppo vicino. banco_postgresql_e_psql e banco_postgresql_e_psql_ricarica sono due database diversi: un nome che comincia allo stesso modo non è lo stesso. Con \l banco* vedi tutti quelli che cominciano per «banco» e controlli di non confonderli.
Se il problema non è PostgreSQL
pytest: command not found, No module named pytest, il pannello Testing vuoto: è il venv, non il database. Ha una pagina sua: pytest non parte, o non trova niente. Per le cure brevi dei sintomi di PostgreSQL c'è anche il Pronto soccorso, con la ricerca.