接続する
ダッシュボードのデータベースのページから接続 URL をコピーします。rediss:// (s が 2 つ) です。サーバーは TLS のみを受け付け、平文用のポートはありません。クライアント証明書は不要です。サーバーを検証する場合は、接続 → SSL/TLS 証明書の .pem を CA として使います。2026 年 9 月 29 日より前に作成したデータベースの URL を保存している場合、redis:// のままになっていることがあります。rediss:// に変更してください。
- node-redis
- ioredis
- Python
- redis-cli
接続の動作
- アイドル状態のクライアントは 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 でキーをバッチで削除します。
組み込みモジュール
検索クエリは、データベースの 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 も失敗します。保存には、現在のデータファイルとは別に、データとほぼ同じサイズの空きストレージが必要です。

