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

# Redis en Square Cloud: conexión, memoria y persistencia

> Redis gestionado en Square Cloud: conexión TLS con rediss://, timeout por inactividad, comandos bloqueados, módulos integrados (Search, JSON, TimeSeries), política de memoria noeviction, persistencia y errores comunes.

Un servidor de Redis gestionado al que se accede por TLS, con los módulos Search, JSON, TimeSeries, probabilísticos y de vector sets integrados. Lo que comparten todos los motores (límites, snapshots, Insights) está en la [visión general de bases de datos](https://docs.squarecloud.app/es/services/databases.md).

## Conectarse

Copia la URL de conexión desde la página de la base de datos en el dashboard:

```
rediss://default:PASSWORD@HOST:PORT
```

El esquema es **`rediss://`** (con dos s): el servidor solo acepta TLS y no hay puerto sin cifrar. No se necesita certificado de cliente; para verificar el servidor, usa el `.pem` de **Conexión** → **Certificado SSL/TLS** como CA. Una URL guardada de una base de datos creada antes del 29 de septiembre de 2026 puede seguir diciendo `redis://`: cámbiala a `rediss://`.

> [tab] node-redis
>
> ```javascript theme={"system"}
> import fs from "node:fs";
> import { createClient } from "redis";
>
> // One client for the whole process, created once and reused.
> export const redis = createClient({
>   url: process.env.REDIS_URL,
>   socket: { tls: true, ca: fs.readFileSync("certificate.pem", "utf8") },
>   pingInterval: 60_000, // keeps the connection from being closed as idle
> });
>
> redis.on("error", (err) => console.error("Redis error", err));
> await redis.connect();
> ```

> [tab] ioredis
>
> ```javascript theme={"system"}
> import fs from "node:fs";
> import Redis from "ioredis";
>
> export const redis = new Redis(process.env.REDIS_URL, {
>   tls: { ca: fs.readFileSync("certificate.pem", "utf8") },
> });
> ```

> [tab] Python
>
> ```python theme={"system"}
> import os
> import redis
>
> r = redis.from_url(
>     os.environ["REDIS_URL"],
>     ssl_ca_certs="certificate.pem",
>     health_check_interval=60,
> )
> ```

> [tab] redis-cli
>
> ```bash theme={"system"}
> redis-cli -u "rediss://default:PASSWORD@HOST:PORT" --tls --cacert certificate.pem
> ```

## Comportamiento de la conexión

* **Los clientes inactivos se desconectan después de 300 segundos.** Usa un cliente que se reconecte automáticamente (node-redis, ioredis y redis-py lo hacen) o envía un `PING` periódico, como en los ejemplos de arriba.
* **Una sola base de datos lógica (0).** `SELECT 1` o superior responde `ERR DB index is out of range`: separa los datos con prefijos de clave (`cache:`, `session:`) en su lugar.
* Hasta 256 clientes simultáneos; a partir de ahí, los nuevos reciben `max number of clients reached`. Crea un cliente por proceso y reutilízalo.
* La autenticación es la contraseña del usuario `default`. No se pueden crear usuarios ACL adicionales.

## Comandos

Todos los comandos de datos funcionan, al igual que los scripts Lua y las Functions, pub/sub, `MULTI`/`EXEC`, `SCAN` y `SLOWLOG`. Estos están bloqueados y responden `NOPERM`: `FLUSHALL`, `FLUSHDB`, `SHUTDOWN`, `CONFIG`, `DEBUG`, `ACL`, `REPLICAOF`/`SLAVEOF` y `FAILOVER`.

Sin `CONFIG`, la política de expulsión y las notificaciones del keyspace no se pueden cambiar. Para vaciar la base de datos, elimina claves por lotes con `SCAN` y `UNLINK`:

```bash theme={"system"}
URL="rediss://default:PASSWORD@HOST:PORT"
redis-cli -u "$URL" --tls --cacert certificate.pem --scan --pattern 'cache:*' \
  | xargs -n 100 redis-cli -u "$URL" --tls --cacert certificate.pem UNLINK
```

## Módulos integrados

| Módulo | Comandos |
| :- | :- |
| Search and Query | `FT.*` (texto completo, índices secundarios, búsqueda vectorial) |
| JSON | `JSON.*` |
| TimeSeries | `TS.*` |
| Probabilísticos | `BF.*`, `CF.*`, `CMS.*`, `TOPK.*`, `TDIGEST.*` |
| Vector sets | `VADD`, `VSIM` y los demás comandos `V*` |

Las consultas de Search se ejecutan en tantos hilos como vCPU tenga la base de datos.

## Memoria

* Redis puede guardar datos hasta el **90% de la RAM de la base de datos**. El otro 10% cubre su propia sobrecarga, los buffers de los clientes y el espacio que necesita un guardado.
* La política es **`noeviction`**: cuando la memoria se llena, no se expulsa nada. Las escrituras fallan con `OOM command not allowed when used memory > 'maxmemory'`, mientras que las lecturas siguen funcionando y el servidor sigue en pie.
* Por eso, **pon una expiración a las claves de caché** (`SET key value EX 3600`, `EXPIRE`), y dimensiona la RAM para los datos que no tienen expiración.
* Cambiar la RAM de la base de datos la reinicia.

## Respuestas grandes

Un cliente cuyas respuestas sin leer superan los 32 MB (o se mantienen por encima de 16 MB durante 60 segundos) se desconecta; para los suscriptores de pub/sub, los límites son 32 MB y 8 MB durante 60 segundos. Los comandos que devuelven respuestas enormes, como `KEYS *` o `HGETALL`/`SMEMBERS` sobre claves gigantes, y los suscriptores que leen demasiado lento, quedan cortados. Itera con `SCAN`, `HSCAN` y `SSCAN` en su lugar.

## Persistencia

* Redis guarda sus datos en disco **cada 60 segundos cuando hubo al menos una escritura**. No hay archivo append-only, así que una caída o una detención por falta de memoria pierde hasta los últimos \~60 segundos de escrituras. Guarda también en una base de datos principal los datos que no puedes perder.
* Si un guardado falla (almacenamiento lleno, o memoria insuficiente para guardar), las escrituras responden `MISCONF` hasta que un guardado tenga éxito, y mientras tanto los snapshots fallan. Un guardado necesita almacenamiento libre junto al archivo de datos actual, de aproximadamente el tamaño de los datos.

## Restablecer la contraseña

Restablecer la contraseña reinicia Redis, que solo lee su contraseña al iniciar: queda fuera de línea unos segundos y todas las conexiones se cierran. Actualiza la URL en tus aplicaciones y deja que se reconecten.

## Snapshots

Un snapshot de Redis es su archivo de datos guardado. Restaurar uno recupera los datos y conserva la contraseña actual de la base de datos. Consulta [snapshots y restauración](https://docs.squarecloud.app/es/services/databases.md#snapshots-y-restauración).

## Errores comunes

| Mensaje | Qué significa | Qué hacer |
| :- | :- | :- |
| La conexión se cierra de inmediato, `ECONNRESET` o un timeout | La URL usa `redis://`, sin TLS. | Usa `rediss://`. |
| `OOM command not allowed when used memory > 'maxmemory'` | La memoria está llena y no se expulsa nada. | Añade expiraciones a las claves de caché, elimina datos o añade RAM. |
| `MISCONF Redis is configured to save RDB snapshots, but it's currently unable to persist to disk` | El último guardado falló. | Libera almacenamiento y memoria; las escrituras se reanudan cuando un guardado tiene éxito. |
| `ERR DB index is out of range` | Solo existe la base de datos 0. | Usa prefijos de clave en lugar de `SELECT`. |
| `NOPERM ... has no permissions to run the '...' command` | El comando está bloqueado. | Usa `SCAN` + `UNLINK` en lugar de `FLUSHALL`/`FLUSHDB`. |
| `max number of clients reached` | Las 256 conexiones están en uso. | Reutiliza un cliente por proceso. |

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