> ## 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 sur Square Cloud : connexion, mémoire et persistance

> Redis géré sur Square Cloud : connexion TLS rediss://, délai d'inactivité, commandes bloquées, modules intégrés (Search, JSON, TimeSeries), politique mémoire noeviction, persistance et erreurs courantes.

Un serveur Redis géré joignable en TLS, avec les modules Search, JSON, TimeSeries, probabilistes et vector sets intégrés. Les informations communes à tous les moteurs (limites, snapshots, Insights) se trouvent dans la [vue d'ensemble des bases de données](https://docs.squarecloud.app/fr/services/databases.md).

## Se connecter

Copiez l'URL de connexion depuis la page de la base de données dans le tableau de bord :

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

Le schéma est **`rediss://`** (deux s) : le serveur n'accepte que TLS, et il n'y a pas de port en clair. Aucun certificat client n'est nécessaire ; pour vérifier le serveur, utilisez le `.pem` de **Connexion** → **Certificat SSL/TLS** comme CA. Une URL enregistrée pour une base de données créée avant le 29 septembre 2026 peut encore indiquer `redis://` : remplacez-la par `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
> ```

## Comportement des connexions

* **Les clients inactifs sont déconnectés après 300 secondes.** Utilisez un client qui se reconnecte automatiquement (node-redis, ioredis et redis-py le font) ou envoyez un `PING` périodique, comme dans les exemples ci-dessus.
* **Une seule base logique (0).** `SELECT 1` ou plus répond `ERR DB index is out of range` : séparez plutôt les données avec des préfixes de clés (`cache:`, `session:`).
* Jusqu'à 256 clients simultanés ; au-delà, les nouveaux reçoivent `max number of clients reached`. Créez un seul client par processus et réutilisez-le.
* L'authentification se fait avec le mot de passe de l'utilisateur `default`. Il n'est pas possible de créer d'autres utilisateurs ACL.

## Commandes

Toutes les commandes de données fonctionnent, tout comme les scripts Lua et les Functions, le pub/sub, `MULTI`/`EXEC`, `SCAN` et `SLOWLOG`. Celles-ci sont bloquées et répondent `NOPERM` : `FLUSHALL`, `FLUSHDB`, `SHUTDOWN`, `CONFIG`, `DEBUG`, `ACL`, `REPLICAOF`/`SLAVEOF` et `FAILOVER`.

Sans `CONFIG`, la politique d'éviction et les notifications d'espace de clés (keyspace notifications) ne peuvent pas être modifiées. Pour vider la base de données, supprimez les clés par lots avec `SCAN` et `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
```

## Modules intégrés

| Module | Commandes |
| :- | :- |
| Search and Query | `FT.*` (texte intégral, index secondaires, recherche vectorielle) |
| JSON | `JSON.*` |
| TimeSeries | `TS.*` |
| Probabilistes | `BF.*`, `CF.*`, `CMS.*`, `TOPK.*`, `TDIGEST.*` |
| Vector sets | `VADD`, `VSIM` et les autres commandes `V*` |

Les requêtes Search s'exécutent sur autant de threads que la base de données a de vCPU.

## Mémoire

* Redis peut stocker des données jusqu'à **90 % de la RAM de la base de données**. Les 10 % restants couvrent sa propre surcharge, les tampons des clients et l'espace nécessaire à un enregistrement sur disque.
* La politique est **`noeviction`** : quand la mémoire est pleine, rien n'est évincé. Les écritures échouent avec `OOM command not allowed when used memory > 'maxmemory'`, tandis que les lectures continuent de fonctionner et que le serveur reste en ligne.
* Donnez donc **une expiration aux clés de cache** (`SET key value EX 3600`, `EXPIRE`), et dimensionnez la RAM pour les données sans expiration.
* Modifier la RAM de la base de données la redémarre.

## Réponses volumineuses

Un client dont les réponses non lues dépassent 32 Mo (ou restent au-dessus de 16 Mo pendant 60 secondes) est déconnecté ; pour les abonnés pub/sub, les limites sont de 32 Mo et de 8 Mo pendant 60 secondes. Les commandes qui renvoient d'énormes réponses, comme `KEYS *` ou `HGETALL`/`SMEMBERS` sur des clés géantes, et les abonnés qui lisent trop lentement, sont coupés. Itérez plutôt avec `SCAN`, `HSCAN` et `SSCAN`.

## Persistance

* Redis enregistre ses données sur disque **toutes les 60 secondes dès qu'au moins une écriture a eu lieu**. Il n'y a pas de fichier append-only, donc un crash ou un arrêt par manque de mémoire fait perdre jusqu'aux \~60 dernières secondes d'écritures. Gardez aussi les données que vous ne pouvez pas perdre dans une base de données de référence.
* Si un enregistrement échoue (stockage plein, ou pas assez de mémoire pour enregistrer), les écritures répondent `MISCONF` jusqu'à ce qu'un enregistrement réussisse, et les snapshots échouent entre-temps. Un enregistrement a besoin d'espace libre à côté du fichier de données actuel, environ de la taille des données.

## Réinitialisation du mot de passe

Réinitialiser le mot de passe redémarre Redis, qui ne lit son mot de passe qu'au démarrage : il est hors ligne pendant quelques secondes et toutes les connexions se ferment. Mettez à jour l'URL dans vos applications et laissez-les se reconnecter.

## Snapshots

Un snapshot Redis est son fichier de données enregistré. En restaurer un ramène les données et conserve le mot de passe actuel de la base de données. Voir [snapshots et restauration](https://docs.squarecloud.app/fr/services/databases.md#snapshots-et-restauration).

## Erreurs courantes

| Message | Ce que ça signifie | Que faire |
| :- | :- | :- |
| La connexion se ferme aussitôt, `ECONNRESET` ou un délai dépassé | L'URL utilise `redis://`, sans TLS. | Utilisez `rediss://`. |
| `OOM command not allowed when used memory > 'maxmemory'` | La mémoire est pleine, et rien n'est évincé. | Ajoutez des expirations aux clés de cache, supprimez des données ou ajoutez de la RAM. |
| `MISCONF Redis is configured to save RDB snapshots, but it's currently unable to persist to disk` | Le dernier enregistrement a échoué. | Libérez du stockage et de la mémoire ; les écritures reprennent après un enregistrement réussi. |
| `ERR DB index is out of range` | Seule la base 0 existe. | Utilisez des préfixes de clés au lieu de `SELECT`. |
| `NOPERM ... has no permissions to run the '...' command` | La commande est bloquée. | Utilisez `SCAN` + `UNLINK` au lieu de `FLUSHALL`/`FLUSHDB`. |
| `max number of clients reached` | Les 256 connexions sont toutes utilisées. | Réutilisez un seul client par processus. |

## Contactez-nous

Si vous rencontrez toujours des **difficultés techniques**, notre **équipe de support spécialisée** est disponible pour vous aider. [**Contactez-nous**](https://squarecloud.app/fr/support) et nous serons ravis de vous aider à résoudre tout problème. La qualité du support compte pour beaucoup dans la note que les développeurs donnent à Square Cloud, [**4,9/5 sur 402 avis**](https://www.trustpilot.com/review/squarecloud.app) sur Google et Trustpilot.


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