> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Memoria, connessioni e query lente del database

> Risolvi i problemi del database su Square Cloud: RAM che continua a crescere, arresti per memoria esaurita, troppe connessioni, query lente, un disco pieno e avvii lenti dopo un arresto forzato.

La maggior parte dei problemi del database si presenta come memoria che sembra perdersi, connessioni che si esauriscono o query che diventano lente. Parti dal sintomo qui sotto; i dettagli di ogni motore si trovano nelle pagine di [PostgreSQL](https://docs.squarecloud.app/it/services/databases/postgresql.md), [MySQL](https://docs.squarecloud.app/it/services/databases/mysql.md), [MongoDB](https://docs.squarecloud.app/it/services/databases/mongodb.md) e [Redis](https://docs.squarecloud.app/it/services/databases/redis.md).

## La RAM continua a crescere

**Cosa significa:** il grafico della RAM del database sale dopo l'avvio e poi resta alto, anche quando il traffico cala.

**Perché accade:** la RAM mostrata nella dashboard è l'intera memoria dell'istanza, compresa la cache dei file del sistema operativo che il motore mantiene calda. Ogni motore trattiene anche memoria di proposito:

* **PostgreSQL:** `shared_buffers` (25% della RAM) più la cache dei file.
* **MongoDB:** la cache WiredTiger, e un allocatore che conserva la memoria liberata per riutilizzarla.
* **MySQL:** il buffer pool InnoDB (128 MB, se non lo hai aumentato) più la cache dei file.
* **Redis:** i dati stessi, fino al 90% della RAM.

Salire e poi stabilizzarsi è normale, non un memory leak.

**Quando è un problema:** se il database esaurisce la memoria, viene arrestato e resta arrestato finché non lo avvii di nuovo (non c'è riavvio automatico dopo un arresto per memoria esaurita). A quel punto:

1. Avvialo dalla dashboard.
2. Trova cosa è cresciuto: una query o un'aggregazione su troppi dati, troppe connessioni (ognuna costa memoria), oppure su Redis chiavi senza scadenza.
3. Riducilo, oppure dai più RAM al database.

## Troppe connessioni

**Cosa significa:** le nuove connessioni vengono rifiutate:

| Motore | Messaggio |
| :- | :- |
| PostgreSQL | `remaining connection slots are reserved for roles with the SUPERUSER attribute` / `sorry, too many clients already` |
| MySQL | `Too many connections` |
| MongoDB | la connessione si chiude subito |
| Redis | `max number of clients reached` |

**Perché accade:** ogni database accetta fino a 256 connessioni simultanee (253 per i tuoi client su PostgreSQL), qualunque sia la sua dimensione. Le cause abituali sono un nuovo client o una nuova connessione per ogni richiesta, un pool per modulo invece che per processo, diverse app o shard ciascuno con un pool grande, oppure su MongoDB molte istanze di `MongoClient` (ognuna aggiunge 2 connessioni di monitoraggio al suo pool).

**Come risolvere:**

1. Crea **un solo pool o client per processo** all'avvio e riutilizzalo ovunque (`pg.Pool`, `mysql2.createPool`, un solo `MongoClient`, un solo client Redis).
2. Dimensiona i pool in modo che tutti i processi insieme restino sotto il limite, con un margine: 4 processi con un pool di 20 ne usano 80.
3. Apri la scheda **Insights** del database per vedere quali indirizzi client tengono le connessioni (la terza parte di ogni indirizzo IP è oscurata).

## Query lente

**Cosa significa:** le richieste alla tua app diventano lente e la CPU del database resta alta.

**Come trovarle:** la scheda **Insights** elenca le query lente, aggiornate ogni 60 secondi:

* **PostgreSQL e MySQL:** istruzioni con il loro tempo medio, elencate non appena un'esecuzione ha richiesto 100 ms o più.
* **MongoDB:** singole operazioni di 100 ms o più, dal profiler.
* **Redis:** lo `SLOWLOG`, comandi di 10 ms o più.

**Come risolvere:** esegui l'explain del motore sulla query lenta e aggiungi l'indice che le serve (`EXPLAIN ANALYZE` su PostgreSQL, `EXPLAIN` su MySQL, `explain("executionStats")` su MongoDB). Su Redis, sostituisci i comandi che percorrono l'intero keyspace o una chiave gigante (`KEYS`, `HGETALL` su hash enormi) con `SCAN`, `HSCAN` e `SSCAN`. Una query che legge molti dati richiede anche RAM: più RAM mantiene in cache una parte maggiore dei dati.

## Il database si è arrestato da solo

| Causa | Cosa vedi | Cosa succede dopo |
| :- | :- | :- |
| Memoria esaurita | Il database è arrestato; il grafico della RAM ha raggiunto il limite. | Resta arrestato finché non lo avvii. Vedi [La RAM continua a crescere](#la-ram-continua-a-crescere). |
| Crash con un errore | Il database si è arrestato in modo imprevisto. | Si riavvia automaticamente, al massimo una volta all'ora, e solo se era in esecuzione da almeno 60 secondi. |
| Storage pieno (MongoDB) | MongoDB ha smesso di scrivere e si è spento. | Resta arrestato. Vedi [il disco è pieno](#il-disco-è-pieno). |

## Il disco è pieno

Ogni database ha **10 GB di storage**, fissi. Dati, indici e i file del motore stesso li condividono: il write-ahead log di PostgreSQL (da 256 a 512 MB), i dati diagnostici di MongoDB (fino a 200 MB), la tabella `mysql.slow_log` di MySQL quando attivi lo slow log, e su Redis lo spazio che serve a un salvataggio accanto al suo file di dati.

| Motore | Cosa succede quando è pieno |
| :- | :- |
| PostgreSQL | Le scritture falliscono (`could not extend file ... No space left on device`). |
| MySQL | Le scritture falliscono (`The table '...' is full`). |
| MongoDB | Il server si arresta e non riparte da solo. |
| Redis | I salvataggi falliscono, e le scritture rispondono `MISCONF` finché un salvataggio non riesce. |

**Come risolvere:**

1. Elimina o archivia i dati che non ti servono, ed elimina gli indici inutilizzati. File come immagini e upload vanno su [Blob Storage](https://docs.squarecloud.app/it/services/blob.md), non nel database.
2. Recupera lo spazio: su PostgreSQL un semplice `VACUUM` lo rende riutilizzabile all'interno della tabella, mentre `VACUUM FULL` lo restituisce al disco ma, durante l'esecuzione, richiede spazio libero pari alla dimensione della tabella. Su MySQL, `OPTIMIZE TABLE` ricostruisce la tabella. Su MongoDB, `compact` sulla collection.
3. Su MongoDB, avvia prima il database dalla dashboard, poi libera subito spazio.

> [!WARNING]
>
> Un database vicino ai suoi 10 GB può anche non riuscire a creare uno snapshot: un'esportazione è limitata a circa 10 GB, e le esportazioni di PostgreSQL e MySQL sono testo SQL non compresso. Mantieni un margine.

## Avvio lento dopo un arresto

**Cosa significa:** subito dopo l'avvio, PostgreSQL risponde `the database system is not yet accepting connections`, oppure MySQL impiega molto tempo ad accettare connessioni.

**Perché accade:** l'arresto di un database gli concede 5 secondi per spegnersi in modo pulito; un database occupato può aver bisogno di più tempo e viene quindi arrestato forzatamente. All'avvio successivo esegue il crash recovery (PostgreSQL riesegue il suo write-ahead log, InnoDB di MySQL ripristina le sue tabelle), che richiede più tempo sui database grandi.

**Come risolvere:** attendi che il ripristino finisca; aspettare non fa perdere nulla. Arresta il database quando il suo carico di scrittura è basso.

## Guide correlate

* [Panoramica dei database](https://docs.squarecloud.app/it/services/databases.md): limiti, snapshot, Insights e cosa include ogni database.
* [Errori di connessione al database](https://docs.squarecloud.app/it/platform/troubleshooting/database-connection-errors.md): errori SSL/TLS, di autenticazione e di rete.

## Contattaci

Se continui a riscontrare **difficoltà tecniche**, il nostro **team di supporto specializzato** è disponibile ad assisterti. [**Contattaci**](https://squarecloud.app/it/support) 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**](https://www.trustpilot.com/review/squarecloud.app) su Google e Trustpilot.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.