Guide all'installazione

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.

Aurora YazılımRedazione 6 min di lettura
Installing PostgreSQL and Basic Settings
Come si installa PostgreSQL?

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.

powershellControllo del PATH e verifica della versione
# The folder name changes with the major version you installed $env:Path += ";C:\Program Files\PostgreSQL\<version>\bin" psql --version psql -U postgres -h localhost

macOS (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.

bash
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 postgres

Ubuntu 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ì.

bash
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.
bash
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 postgres

Creare 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.

sqlDentro psql, come utente postgres
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.

ComandoCosa fa?
\lElenca i database
\c magazaPassa al database magaza
\dtElenca le tabelle dello schema corrente
\d urunlerMostra le colonne e gli indici della tabella
\duElenca i ruoli e i loro privilegi
\xPassa dalle righe larghe alla visualizzazione verticale
\timingAttiva o disattiva la misurazione dei tempi delle query
\?Apre la guida di tutti i meta-comandi
\qEsce da psql
bashConnessione con il nuovo ruolo
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.
sql
SHOW config_file; SHOW hba_file; SHOW data_directory;
confRiga di esempio di pg_hba.conf
# TYPE DATABASE USER ADDRESS METHOD host magaza uygulama 203.0.113.10/32 scram-sha-256
bash
# A reload is enough for a pg_hba.conf change sudo systemctl reload postgresql # A listen_addresses change requires a restart sudo systemctl restart postgresql

Backup 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.

ErroreCausa probabile e soluzione
Peer authentication failedSu Ubuntu le connessioni locali tramite socket usano il metodo peer; aggiungi -h localhost per connetterti con una password.
Connection refusedIl servizio non è in esecuzione o la porta è diversa; controlla systemctl status postgresql e l'impostazione della porta.
password authentication failedLa password o il nome utente sono sbagliati; reimposta la password con ALTER ROLE.
psql non è riconosciutoLa cartella bin non è nel PATH; su Windows, aggiungila alla variabile d'ambiente.
permission denied for schema publicIl ruolo non è il proprietario del database; assegna la proprietà oppure definisci i privilegi sullo schema.
bash
pg_dump -h localhost -U uygulama -F c -f magaza.dump magaza pg_restore -h localhost -U uygulama -d magaza --clean magaza.dump

Domande 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.