跳转到主要内容
一个通过 TLS 访问的托管 Redis 服务器,内置 Search、JSON、TimeSeries、概率数据结构和向量集合(vector set)模块。所有引擎共有的信息(限制、snapshot、Insights)请参阅数据库概览。

连接

从控制台中该数据库的页面复制连接 URL:
协议是 rediss://(两个 s):服务器只接受 TLS,没有明文端口。不需要客户端证书;如需校验服务器,请将 连接 → SSL/TLS 证书 中的 .pem 作为 CA。2026 年 9 月 29 日之前创建的数据库,保存下来的 URL 可能仍是 redis://:请将其改为 rediss://。

连接行为

  • 空闲客户端会在 300 秒后被断开。 请使用能自动重连的客户端(node-redis、ioredis 和 redis-py 都可以),或者像上面的示例那样定期发送 PING。
  • 只有一个逻辑数据库(0)。 SELECT 1 或更大的编号会返回 ERR DB index is out of range:请改用键前缀(cache:、session:)来区分数据。
  • 最多 256 个同时客户端;超过之后,新客户端会收到 max number of clients reached。请为每个进程创建一个客户端并重复使用。
  • 身份验证使用 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% 用于自身开销、客户端缓冲区以及保存数据时所需的空间。
  • 策略为 noeviction:内存写满时不会淘汰任何数据。写入会失败并提示 OOM command not allowed when used memory > 'maxmemory',而读取仍然正常,服务器也保持运行。
  • 因此请为缓存键设置过期时间(SET key value EX 3600、EXPIRE),并按没有过期时间的数据量来确定 RAM 大小。
  • 修改数据库的 RAM 会重启数据库。

大型回复

如果一个客户端未读取的回复超过 32 MB(或在 60 秒内持续高于 16 MB),它会被断开;对于 pub/sub 订阅者,限制为 32 MB 以及 60 秒内 8 MB。返回巨大回复的命令(例如 KEYS *,或对超大键执行 HGETALL/SMEMBERS)以及读取过慢的订阅者都会被切断。请改用 SCAN、HSCAN 和 SSCAN 进行迭代。

持久化

  • 只要至少发生过一次写入,Redis 每 60 秒就会把数据保存到磁盘。 没有 append-only 文件,因此崩溃或因内存不足而停止时,最多会丢失最近约 60 秒的写入。不能丢失的数据请同时保存在一个作为主记录的数据库中。
  • 如果保存失败(存储已满,或内存不足以完成保存),写入会返回 MISCONF,直到某次保存成功为止,在此期间 snapshot 也会失败。保存时,当前数据文件旁边需要有大约与数据大小相当的空闲存储。

密码重置

重置密码会重启 Redis,因为它只在启动时读取密码:它会离线几秒钟,所有连接都会关闭。请在你的应用中更新 URL,并让它们重新连接。

Snapshot

Redis 的 snapshot 就是它保存的数据文件。恢复 snapshot 会把数据恢复回来,并保留数据库当前的密码。参见 snapshot 与恢复。

常见错误

联系我们

如果你仍然遇到技术问题,我们的专业支持团队可以为你提供帮助。联系我们,我们很乐意协助你解决任何问题,支持质量正是开发者给予 Square Cloud 4.9/5 评分(共 402 条评价)(Google 与 Trustpilot)的重要原因之一。