Redis Cluster
功能的Redis 集群、ElastiCache 集群模式和 MemoryDB:槽位路由、为不可达节点地址准备的节点地图、每个节点独立的 SSH 转发,以及拓扑结构。
SQLLY 连接到 Redis 集群、自托管集群、集群模式下的 Amazon ElastiCache 以及 Amazon MemoryDB,并将每个命令路由到拥有其键哈希槽的节点。当集群移动一个槽(故障转移或重新分片)时,客户端会跟随
MOVED 或者 ASK 回复,更新其槽位映射,并告诉你脚本遇到了多少次重定向。键浏览器、内存分析器、批量操作、Profiler 和 Pub/Sub 查看器都能在所有主节点上工作。
正在连接
像往常一样创建一个 Redis 连接。在 服务器 你可以列出几个种子节点,用逗号分隔(10.0.0.1:7000, 10.0.0.2:7001);没有端口的条目会使用 端口 字段。粘贴一个 URL,例如
redis://user:[email protected]:7000,10.0.0.2:7001 保留每个主机。在
集群模式 选择:
- 自动检测 (默认)——首次连接会询问服务器
INFO cluster并在你退出前一直记住结果,所以每台服务器每个会话只多一次探测,其他一切照旧。 - 单服务器 - 永不按槽路由,即使服务器是集群节点。
- Redis Cluster - 总是按槽路由。
集群只有一个逻辑数据库,所以请把 数据库 留空或设为 0。对于 ElastiCache,把连接指向集群的配置端点;MemoryDB 则本身就是集群。
节点映射:当节点通告了你连不上的地址时
集群节点用它们配置好的通告地址告诉客户端其他节点在哪里。而在 NAT、Docker 端口映射或 SSH 堡垒机之后,这些往往是这台机器无法访问的内网地址。 集群节点映射 字段重写它们:一个 advertised host:port => dial host:port 每行,例如 10.0.0.5:7001 => 127.0.0.1:17001。对外公布的地址仍然用来指代节点(槽映射、重定向和 TLS 服务器名称都用它);只有套接字本身连接到拨号地址。
编辑器在集群上会拒绝什么
每个命令在发送前都会被拒绝,并附带一条指明规则名称的消息:
- 跨槽位的多键命令 -
MGET,MSET,DEL具有多个键,SUNION,RENAME,EVAL这类涉及多个键的命令,只有在所有键都映射到同一槽位时才能运行。给相关的键一个共同的哈希标签:user:{42}:profile和user:{42}:cart共享一个槽位。 SELECT后接非 0 值 - 一个集群只有一个逻辑数据库。KEYS和SCAN-KEYS将会阻塞每个主节点,并且一个SCAN游标属于一个节点。使用键浏览器,或者SQLLY.KEYS pattern [limit [cursor]],它会分页遍历每个主节点,并返回一个可跨节点继续的游标。MULTI/EXEC- 每条命令都是单独路由的,因此事务无法从编辑器保持在同一个节点上。
在选定节点上运行命令
在一行前加上 SQLLY.ON 以及一个目标,可以把命令发到你选定的节点,而不是键所在的节点。目标是 masters,
replicas, all,一个节点的 host:port 按集群拓扑视图列出的写法书写,或者用逗号分隔的多个:
SQLLY.ON masters DBSIZE- 每个主节点一行,显示其键的数量。SQLLY.ON masters FLUSHALL- 清空所有主节点(副本会跟着清空)。SQLLY.ON 10.0.0.4:7003 INFO replication- 某个副本自身的答案。SQLLY.ON replicas DBSIZE- 检查每个副本持有的键数是否与其主节点相同。
这行命令会在每个节点上按输入原样执行,就像 redis-cli 的做法,但不需要
-c: 不跟随重定向,因此不持有该键的节点会回答
MOVED,而上面被拒绝的命令(KEYS, SCAN)在所选节点上运行。副本会切换为 READONLY 排在最前,以便由它们处理键读取。多个节点在同一个网格中作答,并带有 节点 和
角色 列,而返回错误的节点会有自己的一行;在命令于任何节点上运行之前,每个节点都会先连接,因此一个连不上的节点会在任何节点运行之前让整条命令中止。这个前缀不改变任何安全行为:只读连接仍然会拒绝 SQLLY.ON masters FLUSHALL,而写入和破坏性命令仍会请求确认。在集群拓扑视图中,选择一个节点并按
在节点上查询 即可打开一个从该节点行开始的查询选项卡。
脚本运行期间如果客户端跟随了重定向,“消息”窗格会显示次数(例如故障转移之后)。集群刚迁移槽位时出现这种情况很正常;持续不断的重定向则说明正在进行重分片。
面向整个集群的工具
- 键浏览器 - 依次列出每个主节点上的键,直到用完常规预算;提前停止时,备注行会说明它在多少个主节点里扫描了多少个键,并且 扫描更多 从停止的节点继续。
- 内存分析器 - 样本会按各主节点的键数量成比例分配,再把各节点的结果汇总相加。
- 批量删除 - 匹配的键按哈希槽分组,因此每个
UNLINK批次都留在同一个槽位内。 - 分析器 - 运行
MONITOR会同时作用于每个主节点,并把多条流合并进一张表,带有 节点 列。 - Pub/Sub 查看器 - 键空间通知会在每个主节点上订阅(它们按节点生效),普通通道和模式订阅则只在一个主节点上(集群会
PUBLISH各处),以及分片通道——输入时要在开头加上#,例如#orders- 在拥有该通道的主节点上。每行带有一个 节点 列。分片频道在独立的 Redis 7 服务器上也能用。
集群拓扑
右键单击 Redis 数据库并选择 工具 › 集群拓扑…,运行一个
Redis 集群拓扑… 从命令面板,或者用集群连接的服务器仪表板中的链接打开。该窗格会列出所有来自
CLUSTER SHARDS (或者 CLUSTER NODES 在 7.0 之前的服务器上):其 ID、角色、它对外公布的地址、SQLLY 实际连接它的地址、其公布的主机名和客户端发送的 TLS 服务器名称、槽位、健康状况、复制偏移量和链路状态。页脚会统计主节点和从节点,检查 16,384 个槽位是否全部覆盖,并指出不健康或实际连接地址与其公布地址不一致的节点。
跟踪 对每个节点执行与“测试连接”相同的逐步检查:名称查找、隧道或代理(使用节点映射)、TCP、TLS(对照节点通告的地址检查)、登录、协议和 ping、数据库,以及 CLUSTER INFO - 每个步骤一行,所以第一处失败就会告诉你该修什么:节点映射条目写错、端口被挡、TLS 名称不匹配、ACL 问题,或者某个节点没报告集群健康。这两份报告也都提供 SQLLY.TOPOLOGY 和 SQLLY.TRACE 在查询标签页中运行;它们只读取。