集群插槽 (已弃用)

CLUSTER SLOTS

自版本可用

3.0.0

时间复杂度

O(N)，其中 N 是集群节点的总数

ACL 类别

@slow,

CLUSTER SLOTS 返回有关哪些集群插槽映射到哪些 Redis 实例的详细信息。该命令适用于 Redis 集群客户端库实现，用于检索（或在接收到重定向时更新）将集群哈希插槽与实际节点网络信息关联的映射，以便在接收到命令时，可以将其发送到可能适合命令中指定的键的正确实例。

每个节点的网络信息是一个包含以下元素的数组

• 首选端点（IP 地址、主机名或 NULL）
• 端口号
• 节点 ID
• 其他网络元数据的映射

首选端点及其端口定义了客户端应使用哪个位置来发送给定插槽的请求。端点的 NULL 值表示节点具有未知端点，客户端应连接到与发送CLUSTER SLOTS命令相同的端点，但端口从命令返回。这种未知端点配置在 Redis 不知道端点的负载均衡器后面的 Redis 节点中很有用。首选哪个端点由cluster-preferred-endpoint-type配置决定。空字符串""是端点字段的另一个异常值，也是 ip 字段的异常值，如果节点不知道自己的 IP 地址，则会返回该值。这可能发生在仅包含一个节点的集群中，或者该节点尚未加入集群的其他部分。如果节点被错误地配置为使用已宣布的主机名，但没有使用cluster-announce-hostname配置任何主机名，则将显示值?。客户端可以以与 NULL 相同的方式处理空字符串，即与发送当前命令相同的端点，而"?"应被视为未知节点，不一定与提供当前命令的节点相同。

其他网络元数据作为每个节点的第四个参数中的映射提供。以下网络元数据可能会被返回

• IP：当首选端点未设置为 IP 时。
• 主机名：当节点具有已宣布的主机名但主端点未设置为主机名时。

嵌套结果数组

每个嵌套结果是

• 开始插槽范围
• 结束插槽范围
• 表示为嵌套网络信息的插槽范围的主节点
• 插槽范围的主节点的第一个副本
• 第二个副本
• ...一直持续到返回此主节点的所有副本。

每个结果都包含列表插槽范围的主实例的所有活动副本。失败的副本不会被返回。

第三个嵌套回复保证是插槽范围的主实例的网络信息。第三个嵌套回复后的所有网络信息都是主节点的副本。

如果集群实例具有非连续插槽（例如 1-400,900,1800-6000），则对于每个顶级插槽范围回复，将重复主节点和副本网络信息结果。

> CLUSTER SLOTS
1) 1) (integer) 0
   2) (integer) 5460
   3) 1) "127.0.0.1"
      2) (integer) 30001
      3) "09dbe9720cda62f7865eabc5fd8857c5d2678366"
      4) 1) hostname
         2) "host-1.redis.example.com"
   4) 1) "127.0.0.1"
      2) (integer) 30004
      3) "821d8ca00d7ccf931ed3ffc7e3db0599d2271abf"
      4) 1) hostname
         2) "host-2.redis.example.com"
2) 1) (integer) 5461
   2) (integer) 10922
   3) 1) "127.0.0.1"
      2) (integer) 30002
      3) "c9d93d9f2c0c524ff34cc11838c2003d8c29e013"
      4) 1) hostname
         2) "host-3.redis.example.com"
   4) 1) "127.0.0.1"
      2) (integer) 30005
      3) "faadb3eb99009de4ab72ad6b6ed87634c7ee410f"
      4) 1) hostname
         2) "host-4.redis.example.com"
3) 1) (integer) 10923
   2) (integer) 16383
   3) 1) "127.0.0.1"
      2) (integer) 30003
      3) "044ec91f325b7595e76dbcb18cc688b6a5b434a1"
      4) 1) hostname
         2) "host-5.redis.example.com"
   4) 1) "127.0.0.1"
      2) (integer) 30006
      3) "58e6e48d41228013e5d9c1c37c5060693925e97e"
      4) 1) hostname
         2) "host-6.redis.example.com"

警告：在将来的版本中，可能会有更多描述节点的元素。通常，客户端实现应该只依赖于某些参数在指定位置，但更多参数可能会跟随，应该忽略。类似地，客户端库应尽可能地应对旧版本可能只具有主端点和端口参数这一事实。

行为更改历史记录

• >= 7.0.0：在节点响应的第一个字段中添加了对主机名和未知端点的支持。

RESP2/RESP3 回复

历史记录

• 从 Redis 4.0.0 版本开始：添加了节点 ID。
• 从 Redis 7.0.0 版本开始：添加了其他网络元数据字段。