> ## 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 auf Square Cloud: Verbindung, Speicher und Persistenz

> Verwaltetes Redis auf Square Cloud: TLS-Verbindung mit rediss://, Leerlauf-Timeout, gesperrte Befehle, integrierte Module (Search, JSON, TimeSeries), Speicherrichtlinie noeviction, Persistenz und häufige Fehler.

Ein verwalteter Redis-Server, erreichbar über TLS, mit den integrierten Modulen Search, JSON, TimeSeries, Probabilistic und Vector Sets. Was für alle Engines gilt (Limits, Snapshots, Insights), steht in der [Datenbank-Übersicht](https://docs.squarecloud.app/de/services/databases.md).

## Verbinden

Kopiere die Verbindungs-URL von der Seite der Datenbank im Dashboard:

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

Das Schema ist **`rediss://`** (mit zwei s): Der Server akzeptiert nur TLS, und es gibt keinen Klartext-Port. Ein Client-Zertifikat ist nicht nötig; um den Server zu prüfen, verwende die `.pem` aus **Verbindung** → **SSL/TLS-Zertifikat** als CA. Eine URL, die du für eine vor dem 29. September 2026 erstellte Datenbank gespeichert hast, kann noch `redis://` enthalten: Ändere sie in `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
> ```

## Verhalten der Verbindungen

* **Inaktive Clients werden nach 300 Sekunden getrennt.** Verwende einen Client, der sich automatisch neu verbindet (node-redis, ioredis und redis-py tun das), oder sende regelmäßig ein `PING`, wie in den Beispielen oben.
* **Eine logische Datenbank (0).** `SELECT 1` oder höher antwortet mit `ERR DB index is out of range`: Trenne Daten stattdessen mit Key-Präfixen (`cache:`, `session:`).
* Bis zu 256 gleichzeitige Clients; darüber hinaus erhalten neue `max number of clients reached`. Erstelle einen Client pro Prozess und verwende ihn wieder.
* Die Authentifizierung erfolgt mit dem Passwort des Benutzers `default`. Zusätzliche ACL-Benutzer können nicht erstellt werden.

## Befehle

Jeder Datenbefehl funktioniert, ebenso Lua-Skripte und Functions, Pub/Sub, `MULTI`/`EXEC`, `SCAN` und `SLOWLOG`. Diese sind gesperrt und antworten mit `NOPERM`: `FLUSHALL`, `FLUSHDB`, `SHUTDOWN`, `CONFIG`, `DEBUG`, `ACL`, `REPLICAOF`/`SLAVEOF` und `FAILOVER`.

Ohne `CONFIG` lassen sich die Eviction-Richtlinie und die Keyspace Notifications nicht ändern. Um die Datenbank zu leeren, lösche Keys in Batches mit `SCAN` und `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
```

## Integrierte Module

| Modul | Befehle |
| :- | :- |
| Search and Query | `FT.*` (Volltext, Sekundärindizes, Vektorsuche) |
| JSON | `JSON.*` |
| TimeSeries | `TS.*` |
| Probabilistic | `BF.*`, `CF.*`, `CMS.*`, `TOPK.*`, `TDIGEST.*` |
| Vector Sets | `VADD`, `VSIM` und die anderen `V*`-Befehle |

Search-Abfragen laufen auf so vielen Threads, wie die Datenbank vCPUs hat.

## Arbeitsspeicher

* Redis kann Daten bis zu **90 % des RAM der Datenbank** halten. Die übrigen 10 % decken den eigenen Overhead, die Client-Puffer und den Platz ab, den ein Speichervorgang auf die Festplatte braucht.
* Die Richtlinie ist **`noeviction`**: Wenn der Speicher voll ist, wird nichts verdrängt. Schreibvorgänge schlagen mit `OOM command not allowed when used memory > 'maxmemory'` fehl, während Lesevorgänge weiter funktionieren und der Server erreichbar bleibt.
* **Gib Cache-Keys also ein Ablaufdatum** (`SET key value EX 3600`, `EXPIRE`) und bemiss den RAM für die Daten ohne Ablaufdatum.
* Eine Änderung des RAM der Datenbank startet sie neu.

## Große Antworten

Ein Client, dessen ungelesene Antworten 32 MB überschreiten (oder 60 Sekunden lang über 16 MB bleiben), wird getrennt; für Pub/Sub-Abonnenten liegen die Grenzen bei 32 MB und bei 8 MB für 60 Sekunden. Befehle, die riesige Antworten liefern, wie `KEYS *` oder `HGETALL`/`SMEMBERS` auf riesigen Keys, und Abonnenten, die zu langsam lesen, werden abgeschnitten. Iteriere stattdessen mit `SCAN`, `HSCAN` und `SSCAN`.

## Persistenz

* Redis speichert seine Daten **alle 60 Sekunden auf die Festplatte, sofern mindestens ein Schreibvorgang stattgefunden hat**. Es gibt kein Append-Only-File, daher gehen bei einem Absturz oder einem Stopp wegen Speichermangels bis zu den letzten \~60 Sekunden an Schreibvorgängen verloren. Bewahre Daten, die du nicht verlieren darfst, zusätzlich in einer führenden Datenbank auf.
* Wenn ein Speichervorgang fehlschlägt (voller Speicherplatz oder nicht genug Arbeitsspeicher zum Speichern), antworten Schreibvorgänge mit `MISCONF`, bis ein Speichervorgang gelingt, und Snapshots schlagen in dieser Zeit fehl. Ein Speichervorgang braucht freien Speicherplatz neben der aktuellen Datendatei, etwa in der Größe der Daten.

## Passwort zurücksetzen

Das Zurücksetzen des Passworts startet Redis neu, das sein Passwort nur beim Start liest: Es ist einige Sekunden offline, und alle Verbindungen werden geschlossen. Aktualisiere die URL in deinen Apps und lass sie sich neu verbinden.

## Snapshots

Ein Redis-Snapshot ist seine gespeicherte Datendatei. Beim Wiederherstellen kommen die Daten zurück, und das aktuelle Passwort der Datenbank bleibt erhalten. Siehe [Snapshots und Wiederherstellung](https://docs.squarecloud.app/de/services/databases.md#snapshots-und-wiederherstellung).

## Häufige Fehler

| Meldung | Bedeutung | Was zu tun ist |
| :- | :- | :- |
| Verbindung wird sofort geschlossen, `ECONNRESET` oder ein Timeout | Die URL verwendet `redis://`, ohne TLS. | Verwende `rediss://`. |
| `OOM command not allowed when used memory > 'maxmemory'` | Der Speicher ist voll, und nichts wird verdrängt. | Gib Cache-Keys ein Ablaufdatum, lösche Daten oder füge RAM hinzu. |
| `MISCONF Redis is configured to save RDB snapshots, but it's currently unable to persist to disk` | Der letzte Speichervorgang ist fehlgeschlagen. | Gib Speicherplatz und Arbeitsspeicher frei; Schreibvorgänge laufen wieder, sobald ein Speichervorgang gelingt. |
| `ERR DB index is out of range` | Es gibt nur die Datenbank 0. | Nutze Key-Präfixe statt `SELECT`. |
| `NOPERM ... has no permissions to run the '...' command` | Der Befehl ist gesperrt. | Nutze `SCAN` + `UNLINK` statt `FLUSHALL`/`FLUSHDB`. |
| `max number of clients reached` | Alle 256 Verbindungen sind belegt. | Verwende einen Client pro Prozess wieder. |

## Kontaktiere uns

Falls du weiterhin **technische Schwierigkeiten** hast, steht dir unser **spezialisiertes Support-Team** zur Verfügung. [**Kontaktiere uns**](https://squarecloud.app/de/support) und wir helfen dir gerne, jedes Problem zu lösen: die Qualität unseres Supports ist ein wichtiger Grund, warum Entwickler Square Cloud mit [**4,9/5 bei 402 Bewertungen**](https://www.trustpilot.com/review/squarecloud.app) auf Google und Trustpilot bewerten.


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