> ## 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, conexiones y consultas lentas en bases de datos

> Soluciona problemas de bases de datos en Square Cloud: RAM que no deja de crecer, detenciones por falta de memoria, demasiadas conexiones, consultas lentas, un disco lleno e inicios lentos tras una detención forzada.

La mayoría de los problemas de bases de datos aparecen como memoria que parece tener una fuga, conexiones que se agotan o consultas que se vuelven lentas. Empieza por el síntoma de abajo; los detalles de cada motor están en las páginas de [PostgreSQL](https://docs.squarecloud.app/es/services/databases/postgresql.md), [MySQL](https://docs.squarecloud.app/es/services/databases/mysql.md), [MongoDB](https://docs.squarecloud.app/es/services/databases/mongodb.md) y [Redis](https://docs.squarecloud.app/es/services/databases/redis.md).

## La RAM no deja de crecer

**Qué significa:** el gráfico de RAM de la base de datos sube después de iniciar y luego se mantiene alto, incluso cuando baja el tráfico.

**Por qué ocurre:** la RAM que muestra el dashboard es toda la memoria de la instancia, incluida la caché de archivos del sistema operativo que el motor mantiene caliente. Cada motor también retiene memoria a propósito:

* **PostgreSQL:** `shared_buffers` (25% de la RAM) más la caché de archivos.
* **MongoDB:** la caché de WiredTiger, y un asignador que conserva la memoria liberada para reutilizarla.
* **MySQL:** el buffer pool de InnoDB (128 MB, salvo que lo hayas aumentado) más la caché de archivos.
* **Redis:** los propios datos, hasta el 90% de la RAM.

Subir y luego estabilizarse es normal, no una fuga.

**Cuándo es un problema:** si la base de datos se queda sin memoria, se detiene y permanece detenida hasta que la vuelvas a iniciar (no hay reinicio automático después de una detención por falta de memoria). Entonces:

1. Iníciala desde el dashboard.
2. Encuentra lo que creció: una consulta o agregación sobre demasiados datos, demasiadas conexiones (cada una cuesta memoria), o en Redis claves sin expiración.
3. Redúcelo, o dale más RAM a la base de datos.

## Demasiadas conexiones

**Qué significa:** las conexiones nuevas se rechazan:

| Motor | Mensaje |
| :- | :- |
| PostgreSQL | `remaining connection slots are reserved for roles with the SUPERUSER attribute` / `sorry, too many clients already` |
| MySQL | `Too many connections` |
| MongoDB | la conexión se cierra de inmediato |
| Redis | `max number of clients reached` |

**Por qué ocurre:** cada base de datos acepta hasta 256 conexiones simultáneas (253 para tus clientes en PostgreSQL), sea cual sea su tamaño. Las causas habituales son un cliente o una conexión nueva por petición, un pool por módulo en lugar de por proceso, varias aplicaciones o shards con un pool grande cada uno, o en MongoDB muchas instancias de `MongoClient` (cada una añade 2 conexiones de monitoreo a su pool).

**Cómo solucionarlo:**

1. Crea **un pool o cliente por proceso** al iniciar y reutilízalo en todas partes (`pg.Pool`, `mysql2.createPool`, un solo `MongoClient`, un solo cliente de Redis).
2. Dimensiona los pools para que todos los procesos juntos queden por debajo del límite, con margen: 4 procesos con un pool de 20 usan 80.
3. Abre la pestaña **Insights** de la base de datos para ver qué direcciones de cliente mantienen las conexiones (la tercera parte de cada dirección IP está oculta).

## Consultas lentas

**Qué significa:** las peticiones a tu aplicación se vuelven lentas y el CPU de la base de datos se mantiene alto.

**Cómo encontrarlas:** la pestaña **Insights** lista las consultas lentas, actualizadas cada 60 segundos:

* **PostgreSQL y MySQL:** sentencias con su tiempo medio, listadas en cuanto alguna ejecución tardó 100 ms o más.
* **MongoDB:** operaciones individuales de 100 ms o más, del profiler.
* **Redis:** el `SLOWLOG`, comandos de 10 ms o más.

**Cómo solucionarlo:** ejecuta el explain del motor sobre la consulta lenta y añade el índice que necesita (`EXPLAIN ANALYZE` en PostgreSQL, `EXPLAIN` en MySQL, `explain("executionStats")` en MongoDB). En Redis, reemplaza los comandos que recorren todo el keyspace o una clave gigante (`KEYS`, `HGETALL` sobre hashes enormes) por `SCAN`, `HSCAN` y `SSCAN`. Una consulta que lee muchos datos también necesita RAM: más RAM mantiene más datos en caché.

## La base de datos se detuvo sola

| Causa | Lo que ves | Lo que pasa después |
| :- | :- | :- |
| Sin memoria | La base de datos está detenida; el gráfico de RAM llegó a su límite. | Permanece detenida hasta que la inicies. Consulta [La RAM no deja de crecer](#la-ram-no-deja-de-crecer). |
| Caída con un error | La base de datos se detuvo inesperadamente. | Se reinicia automáticamente, como máximo una vez por hora, y solo si llevaba al menos 60 segundos en ejecución. |
| Almacenamiento lleno (MongoDB) | MongoDB dejó de escribir y se apagó. | Permanece detenida. Consulta [el disco está lleno](#el-disco-está-lleno). |

## El disco está lleno

Cada base de datos tiene **10 GB de almacenamiento**, fijos. Los datos, los índices y los propios archivos del motor los comparten: el write-ahead log de PostgreSQL (de 256 a 512 MB), los datos de diagnóstico de MongoDB (hasta 200 MB), la tabla `mysql.slow_log` de MySQL cuando activas el slow log, y en Redis el espacio que necesita un guardado junto a su archivo de datos.

| Motor | Qué pasa cuando está lleno |
| :- | :- |
| PostgreSQL | Las escrituras fallan (`could not extend file ... No space left on device`). |
| MySQL | Las escrituras fallan (`The table '...' is full`). |
| MongoDB | El servidor se detiene y no vuelve por sí solo. |
| Redis | Los guardados fallan, y las escrituras responden `MISCONF` hasta que un guardado tenga éxito. |

**Cómo solucionarlo:**

1. Elimina o archiva los datos que no necesitas, y elimina los índices sin uso. Los archivos como imágenes y subidas van en [Blob Storage](https://docs.squarecloud.app/es/services/blob.md), no en la base de datos.
2. Recupera el espacio: en PostgreSQL, un `VACUUM` simple lo deja reutilizable dentro de la tabla, mientras que `VACUUM FULL` lo devuelve al disco pero necesita, mientras se ejecuta, espacio libre del tamaño de la tabla. En MySQL, `OPTIMIZE TABLE` reconstruye la tabla. En MongoDB, `compact` sobre la colección.
3. En MongoDB, primero inicia la base de datos desde el dashboard y luego libera espacio de inmediato.

> [!WARNING]
>
> Una base de datos cerca de sus 10 GB también puede fallar al crear un snapshot: una exportación está limitada a unos 10 GB, y las exportaciones de PostgreSQL y MySQL son texto SQL sin comprimir. Deja un margen.

## Tarda en iniciar después de detenerse

**Qué significa:** justo después de iniciar, PostgreSQL responde `the database system is not yet accepting connections`, o MySQL tarda mucho en aceptar conexiones.

**Por qué ocurre:** al detener una base de datos, se le dan 5 segundos para apagarse de forma limpia; una base de datos ocupada puede necesitar más y entonces se detiene a la fuerza. En el siguiente inicio ejecuta su recuperación tras fallo (PostgreSQL reproduce su write-ahead log, el InnoDB de MySQL recupera sus tablas), que tarda más en bases de datos grandes.

**Cómo solucionarlo:** espera a que termine la recuperación; no se pierde nada por esperar. Detén la base de datos cuando su carga de escritura sea baja.

## Guías relacionadas

* [Visión general de bases de datos](https://docs.squarecloud.app/es/services/databases.md): límites, snapshots, Insights y lo que incluye cada base de datos.
* [Errores de conexión a bases de datos](https://docs.squarecloud.app/es/platform/troubleshooting/database-connection-errors.md): errores de SSL/TLS, de autenticación y de red.

## Contáctanos

Si continúas enfrentando **dificultades técnicas**, nuestro **equipo de soporte especializado** está disponible para ayudarte. [**Contáctanos**](https://squarecloud.app/es/support) y estaremos encantados de ayudarte a resolver cualquier problema: la calidad del soporte es una gran parte de por qué los desarrolladores califican a Square Cloud con [**4.9/5 en 402 reseñas**](https://www.trustpilot.com/review/squarecloud.app) en Google y Trustpilot.


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