Installare PostgreSQL e impostazioni di base
Come installare PostgreSQL su Windows, macOS, Ubuntu e Docker, poi iniziare con pgAdmin, ruoli, database e i comandi psql essenziali.

Per l'installazione di PostgreSQL usa l'installer ufficiale di postgresql.org su Windows, Homebrew su macOS, il pacchetto apt su Ubuntu oppure l'immagine ufficiale postgres su Docker. Poi connettiti come superutente postgres, crea un ruolo e un database separati per la vostra applicazione e verifica la connessione con psql o pgAdmin.
Che cos'è PostgreSQL e perché sceglierlo
PostgreSQL è un sistema di database relazionale gratuito e open source con una storia di quasi quarant'anni. Grazie alla sicurezza transazionale (ACID), ai potenti tipi di dati, al supporto JSONB e alle opzioni di indicizzazione avanzate, viene usato ovunque, dai piccoli progetti alle applicazioni ad alto traffico.
PostgreSQL è una scelta comoda per i dati in cui la coerenza è fondamentale, come prenotazioni, magazzino, ordini o annunci. Per questo la sicurezza transazionale conta in sistemi come una piattaforma di software alberghiero o una piattaforma e-commerce, dove molte persone toccano lo stesso record nello stesso momento. Se volete solo provare in fretta PHP e un database in locale, anche installare XAMPP è un punto di partenza pratico. Anche MySQL è molto diffuso per usi simili; se volete confrontare i due, dai un'occhiata alla nostra guida all'installazione di MySQL.
In questo articolo vediamo tutto ciò che vi servirà il primo giorno dopo l'installazione: creazione di ruoli e database, impostazioni di connessione remota, backup e i messaggi di errore che incontrerai più probabilmente.
Cosa serve prima di installare
Chiarire alcune decisioni prima di iniziare riduce i problemi in seguito. Soprattutto su un server di produzione, decidi in anticipo quale versione major userai; passare da una versione major all'altra richiede un dump e restore, oppure pg_upgrade.
Conta anche il metodo di installazione. Su una macchina di sviluppo, Docker è il modo più semplice per eseguire versioni diverse affiancate tra i progetti senza conflitti. Su un server di produzione, un servizio installato con il gestore di pacchetti del sistema operativo offre una configurazione più prevedibile per ricevere aggiornamenti di sicurezza, monitorare i log e gestire l'avvio automatico.
- Un utente con diritti di amministratore (Windows) o sudo (macOS, Linux)
- La porta 5432 predefinita non utilizzata da un'altra applicazione
- La versione major attualmente supportata, indicata sul sito ufficiale: postgresql.org
- Una password robusta per il superutente, salvata in un luogo sicuro
- Un'installazione di Docker funzionante, se installerai con Docker
Installazione per sistema operativo
Ciascuno dei metodi qui sotto installa da fonti ufficiali o ufficialmente consigliate. Sostituisci il segnaposto della versione nei comandi con la versione major che hai scelto.
Windows
Scarica dalla pagina Windows di postgresql.org l'installer preparato da EDB. La procedura guidata installa insieme il server, pgAdmin, gli strumenti da riga di comando e Stack Builder, e vi chiede la password dell'utente postgres, la porta e la localizzazione.
Dopo l'installazione, aggiungi la cartella bin alla variabile PATH per poter usare il comando psql in qualsiasi terminale. Il collegamento SQL Shell (psql) nel menu Start fa lo stesso lavoro.
# The folder name changes with the major version you installed $env:Path += ";C:\Program Files\PostgreSQL\<version>\bin" psql --version psql -U postgres -h localhostmacOS (Homebrew)
Su Homebrew, PostgreSQL è disponibile come pacchetti con numero di versione. Prima elenca i pacchetti disponibili, poi installa la versione major che desideri e avviala come servizio. Se preferisci un'interfaccia grafica, anche Postgres.app è un'alternativa molto diffusa.
brew search postgresql brew install postgresql@<version> brew services start postgresql@<version> # Versioned packages may not be added to PATH automatically; # apply the echo 'export PATH=...' line from the installation output psql --version psql postgresUbuntu e Debian
Il pacchetto presente nel repository della distribuzione basta per la maggior parte dei progetti. Se vi serve una versione major più recente, potete aggiungere il repository PGDG descritto su postgresql.org e installare da lì.
sudo apt update sudo apt install postgresql postgresql-contrib sudo systemctl enable --now postgresql sudo systemctl status postgresql sudo -u postgres psql -c "SELECT version();"Docker
Per un ambiente di sviluppo, l'immagine ufficiale postgres è la strada più pulita; potete avviare e fermare il database senza installare un servizio permanente sul vostro computer. Monta sempre un volume con nome per non perdere i dati.
- Nelle immagini ufficiali dalla versione 18 in poi, il volume viene montato in /var/lib/postgresql.
- Nelle immagini della versione 17 e precedenti, monta il volume in /var/lib/postgresql/data; controlla la nota nella pagina Docker Hub dell'immagine.
docker run -d --name pg \ -e POSTGRES_PASSWORD=GucluBirParola \ -p 5432:5432 \ -v pgdata:/var/lib/postgresql \ postgres:<version> docker exec -it pg psql -U postgresCreare un utente e un database
Il ruolo postgres incluso nell'installazione è un superutente; collegare l'applicazione con quel ruolo non è sicuro. Per ogni progetto, crea un ruolo separato con privilegi solo sul proprio database.
In PostgreSQL, utente e ruolo sono lo stesso concetto: un ruolo con il privilegio LOGIN si comporta come un utente. Un ruolo che rendi proprietario di un database può creare tabelle nello schema public di quel database.
CREATE ROLE uygulama WITH LOGIN PASSWORD 'BurayaGucluParola'; CREATE DATABASE magaza OWNER uygulama ENCODING 'UTF8'; -- Read-only reporting user CREATE ROLE rapor WITH LOGIN PASSWORD 'BaskaGucluParola'; GRANT CONNECT ON DATABASE magaza TO rapor; \c magaza GRANT USAGE ON SCHEMA public TO rapor; GRANT SELECT ON ALL TABLES IN SCHEMA public TO rapor; ALTER DEFAULT PRIVILEGES FOR ROLE uygulama IN SCHEMA public GRANT SELECT ON TABLES TO rapor;I comandi psql più utili
psql è il client da riga di comando di PostgreSQL. I meta-comandi che iniziano con una barra rovesciata non vengono inviati al server come SQL; li interpreta il client stesso e accelerano molto la navigazione.
| Comando | Cosa fa? |
|---|---|
| \l | Elenca i database |
| \c magaza | Passa al database magaza |
| \dt | Elenca le tabelle dello schema corrente |
| \d urunler | Mostra le colonne e gli indici della tabella |
| \du | Elenca i ruoli e i loro privilegi |
| \x | Passa dalle righe larghe alla visualizzazione verticale |
| \timing | Attiva o disattiva la misurazione dei tempi delle query |
| \? | Apre la guida di tutti i meta-comandi |
| \q | Esce da psql |
psql -h localhost -U uygulama -d magaza # With a connection string psql "postgresql://uygulama@localhost:5432/magaza"Gestire PostgreSQL con pgAdmin
pgAdmin è lo strumento di amministrazione ufficiale e gratuito per PostgreSQL. È incluso nell'installer per Windows; su macOS e Linux si installa separatamente da pgadmin.org oppure si esegue dalla sua immagine Docker.
Al primo avvio, definisci un nuovo server con Register > Server: nella scheda Connection inserisci localhost come host, porta 5432, il vostro nome utente e la password. Una volta connesso, potete esplorare le tabelle, eseguire query con il Query Tool ed eseguire operazioni di backup e ripristino dal menu.
Se vi connetti a un server remoto, è più sicuro usare l'opzione tunnel SSH di pgAdmin che esporre la porta del database a Internet.
Accesso remoto e impostazioni di base
Per impostazione predefinita PostgreSQL ascolta solo le connessioni locali. Poiché la posizione dei file di configurazione varia in base al sistema operativo e alla versione, scopri prima dove si trovano da dentro psql.
Il valore listen_addresses in postgresql.conf stabilisce gli indirizzi su cui restare in ascolto, mentre pg_hba.conf decide quale client viene autenticato e con quale metodo. Per le connessioni con password usa scram-sha-256 e mantieni l'intervallo IP consentito il più ristretto possibile.
- shared_buffers: la documentazione ufficiale consiglia come punto di partenza circa un quarto della memoria su un server dedicato.
- max_connections: invece di impostarlo su un valore alto, usa il connection pooling lato applicazione.
- Per trovare le query lente, abilita l'impostazione log_min_duration_statement e analizzale con EXPLAIN ANALYZE.
SHOW config_file; SHOW hba_file; SHOW data_directory;# TYPE DATABASE USER ADDRESS METHOD host magaza uygulama 203.0.113.10/32 scram-sha-256# A reload is enough for a pg_hba.conf change sudo systemctl reload postgresql # A listen_addresses change requires a restart sudo systemctl restart postgresqlBackup ed errori comuni
Pianifica i backup automatici non appena l'installazione è completata. pg_dump crea una copia coerente di un singolo database; un backup in formato custom può essere ripristinato in modo selettivo con pg_restore. Conserva il backup in una posizione diversa, non sullo stesso server.
Le prestazioni del database influiscono direttamente sulla velocità complessiva di un'applicazione. I risultati arrivano quando tempi delle query, indici e risposta del server vengono gestiti insieme; applichiamo questo approccio olistico nel nostro lavoro di ottimizzazione di velocità e prestazioni.
| Errore | Causa probabile e soluzione |
|---|---|
| Peer authentication failed | Su Ubuntu le connessioni locali tramite socket usano il metodo peer; aggiungi -h localhost per connetterti con una password. |
| Connection refused | Il servizio non è in esecuzione o la porta è diversa; controlla systemctl status postgresql e l'impostazione della porta. |
| password authentication failed | La password o il nome utente sono sbagliati; reimposta la password con ALTER ROLE. |
| psql non è riconosciuto | La cartella bin non è nel PATH; su Windows, aggiungila alla variabile d'ambiente. |
| permission denied for schema public | Il ruolo non è il proprietario del database; assegna la proprietà oppure definisci i privilegi sullo schema. |
pg_dump -h localhost -U uygulama -F c -f magaza.dump magaza pg_restore -h localhost -U uygulama -d magaza --clean magaza.dumpDomande frequenti
01Posso usare PostgreSQL senza pgAdmin?
Sì. pgAdmin è solo un'interfaccia di gestione; il server funziona indipendentemente da essa. psql, i plugin per database degli editor di codice o altri client fanno lo stesso lavoro.
02Devo scegliere PostgreSQL o MySQL?
Entrambi i sistemi sono maturi e affidabili. Se contano soprattutto tipi di dati avanzati, JSONB e query complesse, di solito la scelta giusta è PostgreSQL; se conta un'ampia disponibilità presso i fornitori di hosting, MySQL è spesso quella pratica. La decisione deve seguire le esigenze del vostro progetto.
03Come collego il mio progetto Python a PostgreSQL?
Il driver più diffuso è psycopg; lo usano anche Django e SQLAlchemy. Se il vostro ambiente non è ancora pronto, completa prima i passaggi di installazione di Python, poi installa il driver con pip dentro un ambiente virtuale.
04Come passo a una nuova versione major?
Tra una versione major e l'altra la directory dei dati non può essere usata direttamente. Per i database piccoli si preferisce fare un backup con pg_dumpall e ripristinarlo nella nuova versione; per quelli grandi, lo strumento pg_upgrade. In entrambi i casi, fai prima un backup completo.
Installa PostgreSQL, usalo con un ruolo separato, una regola di accesso ristretta e backup regolari, e avrai posto solide basi. Se cerchi un software che gestisca il lavoro end to end, dalla progettazione del database all'installazione del server, dai un'occhiata alle soluzioni Aurora o contattaci tramite la pagina contatti. Per gli altri passaggi, consulta la categoria guide all'installazione.


