Vai al contenuto principale
Un’istanza PostgreSQL gestita con connessione TLS tramite certificato client, un database e un ruolo tutti tuoi, estensioni popolari pronte da attivare e pg_cron per i job pianificati. Le informazioni comuni a tutti i motori (limiti, snapshot, Insights) si trovano nella panoramica dei database.

Connettersi

Copia l’URL di connessione dalla pagina del database nella dashboard. Ha questa forma, con l’utente squarecloud e il database squarecloud creati per te:
PostgreSQL richiede SSL/TLS e il certificato client, oltre alla password. Scarica il .pem in Connessione → Certificato SSL/TLS e indicalo al client:
I client Go rifiutano sslmode=verify-full con questo certificato (x509: certificate relies on legacy Common Name field): indica l’host solo nel suo Common Name, che Go non verifica più. Usa sslmode=verify-ca, che convalida comunque il certificato.
ORM e altri client (Prisma, Drizzle, JDBC, strumenti grafici) sono trattati in errori di connessione al database.

Connessioni

Ogni database accetta fino a 256 connessioni simultanee, di cui 253 disponibili per i tuoi client. Oltre questo limite, le nuove connessioni falliscono con remaining connection slots are reserved for roles with the SUPERUSER attribute (oppure sorry, too many clients already). Crea un solo pool per processo all’avvio e riutilizzalo, dimensionato in modo che tutte le app, i worker e gli shard insieme restino sotto il limite. Una nuova connessione per ogni richiesta o query esaurisce rapidamente il limite. La scheda Insights mostra chi tiene aperte le connessioni.

Il tuo utente e i permessi

Il ruolo squarecloud ha LOGIN, CREATEDB, CREATEROLE e BYPASSRLS, ed è proprietario del database squarecloud. Puoi creare database, schemi, ruoli e grant, e modificare le impostazioni che un utente normale può modificare, per una sessione o come valore predefinito:
Il ruolo non è un superuser e non ha diritti di replica. Questo esclude:
  • ALTER SYSTEM e le impostazioni riservate ai superuser;
  • COPY ... TO/FROM 'file' lato server (usa \copy in psql, che legge e scrive sulla tua macchina);
  • linguaggi non attendibili come plpython3u;
  • la replica logica e gli strumenti di change data capture che ne hanno bisogno.

Estensioni

Già installate: plpgsql, più pg_cron e pg_stat_statements nel database postgres. Puoi attivare queste in qualsiasi tuo database con CREATE EXTENSION, nel database che le userà: vector (pgvector), pg_trgm, pgcrypto, uuid-ossp, citext, hstore, unaccent, ltree, btree_gin, btree_gist, cube, dict_int, fuzzystrmatch, intarray, isn, lo, seg, tablefunc, tcn, tsm_system_rows, tsm_system_time.
Nessun’altra estensione è disponibile, e non se ne possono aggiungere su richiesta. PostGIS, per esempio, non è disponibile.

Job pianificati con pg_cron

pg_cron si trova nel database postgres. Connettiti a postgres (stesso URL, che termina con /postgres) e pianifica il job in modo che venga eseguito nel tuo database. Gli orari sono in UTC:
Lo storico delle esecuzioni in cron.job_run_details non viene mai ripulito automaticamente. Pianifica una pulizia delle tue righe vecchie:

Memoria e configurazione

  • shared_buffers è il 25% della RAM del database (almeno 128 MB). Cambiare la RAM riavvia il database per applicarlo.
  • Per il resto PostgreSQL si affida alla cache dei file del sistema operativo, quindi la RAM mostrata nella dashboard sale e poi resta alta. È normale, non un memory leak.
  • Una singola query può scrivere al massimo 1 GB di file temporanei (ordinamenti, hash). Oltre questo limite la query fallisce con temporary file size exceeds temp_file_limit: aggiungi un indice o elabora i dati a blocchi.
  • Il write-ahead log occupa da 256 a 512 MB dello storage del database.
  • La configurazione del server è la stessa su ogni database e non può essere modificata per singolo database.

Query lente

Le istruzioni che richiedono 100 ms o più vengono registrate, e la scheda Insights le elenca con il loro tempo medio. Per una tua analisi, connettiti al database postgres, interroga pg_stat_statements e usa EXPLAIN ANALYZE sull’istruzione:

Snapshot

Uno snapshot di PostgreSQL contiene tutti i database e i ruoli dell’istanza. Oltre ai casi generali, fallisce quando un database ha ALLOW_CONNECTIONS false, oppure quando un tuo lock (LOCK TABLE, un ALTER TABLE lungo) lo blocca per più di 5 minuti. L’esportazione è testo SQL semplice, quindi un database vicino ai suoi 10 GB di storage potrebbe non stare in uno snapshot.

Errori comuni

Contattaci

Se continui a riscontrare difficoltà tecniche, il nostro team di supporto specializzato è disponibile ad assisterti. Contattaci e saremo felici di aiutarti a risolvere qualsiasi problema: la qualità del supporto è una parte importante del motivo per cui gli sviluppatori valutano Square Cloud 4,9/5 su 402 recensioni su Google e Trustpilot.