Sentinel

功能的

通过 Redis Sentinel 按主节点名称连接,可从副本读取,并在故障转移后继续正常工作。

由 Sentinel 管理的 Redis 或 Valkey 部署会在旧主节点失效时迁移主节点。Sentinel 连接不是给 SQLly 一个固定主机,而是给它提供 主节点名称 (由哨兵监视),以及一份 哨兵 列表来询问。每次连接时,SQLly 都会按顺序向哨兵询问当前的主节点(SENTINEL GET-MASTER-ADDR-BY-NAME),确认它连到的服务器确实是主节点,然后连接过去。已宕机的哨兵,或在故障转移期间仍指向旧主节点的哨兵,会被跳过,转而询问下一个哨兵。

进行设置

在连接编辑器中选择 Redis(或 Valkey)并打开 通过 Sentinel 连接。填写:

  • 主节点名称 - 名称取自哨兵的 sentinel monitor 行,通常 mymaster.
  • Sentinel 节点 - 一个以逗号分隔的列表,例如 10.0.0.1:26379, 10.0.0.2:26379, 10.0.0.3:26379。没有端口的主机默认使用 26379;IPv6 地址要写成 [::1]:26379.
  • Sentinel 密码 - 仅当哨兵自己要求密码时才写入(requirepass 在哨兵上)。它像其他密码一样保存在系统钥匙串中。

主表单里的用户名和密码用于登录主节点(以及副本节点),与直连时一样;逻辑数据库和 TLS 模式对它们同样生效,访问哨兵时也使用相同的 TLS 模式。Host 和 Port 字段不用于拨号数据连接:如果你把 Host 留空,SQLly 会把第一个哨兵显示在那里。

按 测试 结果会给出响应的主节点以及指定它的哨兵,例如 Sentinel 10.0.0.1:26379 将 10.0.0.5:6379 报告为“mymaster”的主节点.

粘贴 URL

A redis+sentinel:// URL 填充相同的字段: redis+sentinel://app:[email protected]:26379,10.0.0.2:26379/mymaster/2?sentinelPassword=s3cret 列出各个哨兵,然后是主节点名称,然后(可选)是数据库。使用 rediss+sentinel:// 来启用 TLS,并添加 preferReplica=true (或者 readFrom=replica)来开启从副本读取。在普通的 redis:// URL 中使用逗号分隔的主机列表也保持不变。

读取时优先选择副本

开启 读取时优先选择副本 开启后,仅由只读命令组成的脚本(GET, HGETALL, SCAN、键浏览器的读取等)都会在哨兵报告健康的副本上运行。任何写操作——以及任何混入写操作的脚本——都会使用 SELECT,或者为仪表板和工具读取整个服务器的信息——跑在主库上。没有健康的从库时,由主库应答。从库是异步复制的,所以读操作可能短暂返回比主库旧的值。

故障切换

连接还开着时主服务器发生变更,下一个命令会失败——要么连接被断开,要么得到 READONLY 错误(来自已被降级的服务器)。随后 SQLly 会再次询问哨兵,每个脚本一次,并把连接切到新的主节点:

  • A 只读脚本 会重新运行失败的命令并继续执行;你不会看到任何异常。
  • A 写入型脚本 它会直接停下,报出 主节点已更改,请重新运行 并指定新的主节点。连接已经指向那里,所以再次运行脚本即可,但请先检查,因为写入可能恰好在旧主节点下线之前完成,而且脚本中靠前的某些命令可能已经执行过了。

Sentinel 连接会直接拨号连接各 Sentinel 节点、主节点和副本,因此使用 Sentinel 时 SSH 隧道、代理和 Kubernetes 端口转发均不可用。经中继路由的连接尚不支持 Sentinel,测试或连接时会明确提示。Profiler 和 Pub/Sub 查看器会连接到当前主节点。