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

# Square Cloud の Redis: 接続、メモリ、永続化

> Square Cloud のマネージド Redis: rediss:// による TLS 接続、アイドルタイムアウト、ブロックされるコマンド、組み込みモジュール (Search、JSON、TimeSeries)、noeviction メモリポリシー、永続化、よくあるエラー。

TLS 経由で接続し、Search、JSON、TimeSeries、確率的データ構造、ベクトルセットのモジュールを組み込んだマネージド Redis サーバーです。すべてのエンジンに共通する事項 (制限、snapshot、Insights) は[データベースの概要](https://docs.squarecloud.app/ja/services/databases.md)にまとめています。

## 接続する

ダッシュボードのデータベースのページから接続 URL をコピーします。

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

スキームは **`rediss://`** (s が 2 つ) です。サーバーは TLS のみを受け付け、平文用のポートはありません。クライアント証明書は不要です。サーバーを検証する場合は、**接続** → **SSL/TLS 証明書**の `.pem` を CA として使います。2026 年 9 月 29 日より前に作成したデータベースの URL を保存している場合、`redis://` のままになっていることがあります。`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
> ```

## 接続の動作

* **アイドル状態のクライアントは 300 秒後に切断されます。** 自動で再接続するクライアント (node-redis、ioredis、redis-py は再接続します) を使うか、上の例のように定期的に `PING` を送ってください。
* **論理データベースは 1 つ (0) だけです。** `SELECT 1` 以上は `ERR DB index is out of range` を返します。代わりにキーのプレフィックス (`cache:`、`session:`) でデータを分けてください。
* 同時クライアントは最大 256 です。それを超えると、新しいクライアントは `max number of clients reached` を受け取ります。プロセスごとに 1 つのクライアントを作成して使い回してください。
* 認証には `default` ユーザーのパスワードを使います。追加の ACL ユーザーは作成できません。

## コマンド

すべてのデータコマンドが使えます。Lua スクリプトと Functions、pub/sub、`MULTI`/`EXEC`、`SCAN`、`SLOWLOG` も同様です。次のコマンドはブロックされており、`NOPERM` を返します: `FLUSHALL`、`FLUSHDB`、`SHUTDOWN`、`CONFIG`、`DEBUG`、`ACL`、`REPLICAOF`/`SLAVEOF`、`FAILOVER`。

`CONFIG` がないため、エビクションポリシーとキースペース通知は変更できません。データベースを空にするには、`SCAN` と `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
```

## 組み込みモジュール

| モジュール | コマンド |
| :- | :- |
| 検索とクエリ | `FT.*` (全文検索、セカンダリインデックス、ベクトル検索) |
| JSON | `JSON.*` |
| TimeSeries | `TS.*` |
| 確率的データ構造 | `BF.*`、`CF.*`、`CMS.*`、`TOPK.*`、`TDIGEST.*` |
| ベクトルセット | `VADD`、`VSIM`、その他の `V*` コマンド |

検索クエリは、データベースの vCPU と同じ数のスレッドで実行されます。

## メモリ

* Redis は**データベースの RAM の 90%** までデータを保持できます。残りの 10% は、Redis 自身のオーバーヘッド、クライアントバッファ、保存に必要な領域に使われます。
* ポリシーは **`noeviction`** です。メモリがいっぱいになっても、何も追い出されません。書き込みは `OOM command not allowed when used memory > 'maxmemory'` で失敗しますが、読み取りは引き続き動作し、サーバーも稼働し続けます。
* そのため、**キャッシュのキーには有効期限を設定**し (`SET key value EX 3600`、`EXPIRE`)、有効期限のないデータに合わせて RAM のサイズを決めてください。
* データベースの RAM を変更すると、再起動します。

## 大きな応答

未読の応答が 32 MB を超えた (または 16 MB を超えた状態が 60 秒続いた) クライアントは切断されます。pub/sub のサブスクライバーの場合、上限は 32 MB と、60 秒間で 8 MB です。`KEYS *` や巨大なキーに対する `HGETALL`/`SMEMBERS` のように巨大な応答を返すコマンドや、読み取りが遅すぎるサブスクライバーは切断されます。代わりに `SCAN`、`HSCAN`、`SSCAN` で反復処理してください。

## 永続化

* Redis は、**少なくとも 1 回書き込みがあった場合、60 秒ごとに**データをディスクに保存します。追記専用ファイル (AOF) はないため、クラッシュやメモリ不足による停止では、直近の最大約 60 秒分の書き込みが失われます。失えないデータは、主となるデータベースにも保存してください。
* 保存に失敗すると (ストレージがいっぱい、または保存に必要なメモリが不足)、保存が成功するまで書き込みは `MISCONF` を返し、その間は snapshot も失敗します。保存には、現在のデータファイルとは別に、データとほぼ同じサイズの空きストレージが必要です。

## パスワードのリセット

パスワードをリセットすると Redis が再起動します。Redis はパスワードを起動時にしか読み込まないためです。数秒間オフラインになり、すべての接続が閉じられます。アプリの URL を更新し、再接続させてください。

## Snapshot

Redis の snapshot は、保存されたデータファイルです。復元するとデータが戻り、データベースの現在のパスワードはそのまま維持されます。[snapshot と復元](https://docs.squarecloud.app/ja/services/databases.md#snapshot-と復元)を参照してください。

## よくあるエラー

| メッセージ | 意味 | 対処方法 |
| :- | :- | :- |
| 接続がすぐに閉じられる、`ECONNRESET`、またはタイムアウト | URL が TLS なしの `redis://` を使っています。 | `rediss://` を使います。 |
| `OOM command not allowed when used memory > 'maxmemory'` | メモリがいっぱいで、何も追い出されません。 | キャッシュのキーに有効期限を付けるか、データを削除するか、RAM を追加します。 |
| `MISCONF Redis is configured to save RDB snapshots, but it's currently unable to persist to disk` | 直近の保存が失敗しました。 | ストレージとメモリを空けます。保存が成功すると書き込みが再開されます。 |
| `ERR DB index is out of range` | データベース 0 しか存在しません。 | `SELECT` の代わりにキーのプレフィックスを使います。 |
| `NOPERM ... has no permissions to run the '...' command` | そのコマンドはブロックされています。 | `FLUSHALL`/`FLUSHDB` の代わりに `SCAN` + `UNLINK` を使います。 |
| `max number of clients reached` | 256 の接続がすべて使用中です。 | プロセスごとに 1 つのクライアントを使い回します。 |

## お問い合わせ

**技術的な問題**が解決しない場合は、**専門のサポートチーム**がお手伝いします。[**お問い合わせ**](https://squarecloud.app/ja/support)いただければ、どのような問題でも喜んで解決をサポートいたします。サポートの質の高さも、開発者が Google と Trustpilot で Square Cloud に[**402 件のレビューで 4.9/5**](https://www.trustpilot.com/review/squarecloud.app)という評価をつけている理由の 1 つです。


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