SYSTEM
集群命令
src/content/notes/system/集群命令.md 集群命令
执行命令
集群处于上线状态,客户端就可以向集群中的节点发送命令(16384 个槽全部指派就进入上线状态)
当客户端向节点发送与数据库键有关的命令时,接收命令的节点会计算出命令该键属于哪个槽,并检查这个槽是否指派给了自己
- 如果键所在的槽正好就指派给了当前节点,那么节点直接执行这个命令
- 反之,节点会向客户端返回一个 MOVED 错误,指引客户端转向(redirect)至正确的节点,再次发送该命令
计算键归属哪个槽的寻址算法:
def slot_number(key): // CRC16(key) 语句计算键 key 的 CRC-16 校验和
return CRC16(key) & 16383; // 取模,十进制对16384的取余
使用 CLUSTER KEYSLOT <key> 命令可以查看一个给定键属于哪个槽,底层实现:
def CLUSTER_KEYSLOT(key):
// 计算槽号
slot = slot_number(key);
// 将槽号返回给客户端
reply_client(slot);
判断槽是否由当前节点负责处理:如果 clusterState.slots[i] 不等于 clusterState.myself,那么说明槽 i 并非由当前节点负责,节点会根据 clusterState.slots[i] 指向的 clusterNode 结构所记录的节点 IP 和端口号,向客户端返回 MOVED 错误
MOVED
MOVED 错误的格式为:
MOVED <slot> <ip>:<port>
参数 slot 为键所在的槽,ip 和 port 是负责处理槽 slot 的节点的 ip 地址和端口号
MOVED 12345 127.0.0.1:6380 # 表示槽 12345 正由 IP地址为 127.0.0.1, 端口号为 6380 的节点负责
当客户端接收到节点返回的 MOVED 错误时,客户端会根据 MOVED 错误中提供的 IP 地址和端口号,转至负责处理槽 slot 的节点重新发送执行的命令
-
一个集群客户端通常会与集群中的多个节点创建套接字连接,节点转向实际上就是换一个套接字来发送命令
-
如果客户端尚未与转向的节点创建套接字连接,那么客户端会先根据 IP 地址和端口号来连接节点,然后再进行转向
集群模式的 redis-cli 在接收到 MOVED 错误时,并不会打印出 MOVED 错误,而是根据错误自动进行节点转向,并打印出转向信息:
$ redis-cli -c -p 6379 #集群模式
127.0.0.1:6379> SET msg "happy"
-> Redirected to slot [6257] located at 127.0.0.1:6380
OK
127.0.0.1:6379>
使用单机(stand alone)模式的 redis-cli 会打印错误,因为单机模式客户端不清楚 MOVED 错误的作用,不会进行自动转向:
$ redis-cli -c -p 6379 #集群模式
127.0.0.1:6379> SET msg "happy"
(error) MOVED 6257 127.0.0.1:6380
127.0.0.1:6379>