# Cluster Slots（已弃用）

获取集群节点的映射数组

从 Redis 版本 7.0.0 开始，此命令被视为已弃用。

它可以CLUSTER SHARDS在迁移或编写新代码时替换。

句法

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 时。
主机名：当节点具有已宣布的主机名但主端点未设置为主机名时。

# 嵌套结果数组

每个嵌套结果是：

起始槽位范围
结束插槽范围
表示为嵌套网络信息的插槽范围的主控
插槽范围的第一个主副本
第二个副本
...继续，直到返回此 master 的所有副本。

每个结果都包括列出的插槽范围内的主实例的所有活动副本。不返回失败的副本。

第三个嵌套回复保证是主实例在插槽范围内的网络信息。第三个嵌套回复之后的所有网络信息都是主服务器的副本。

如果集群实例有非连续槽（例如 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：在节点响应的第一个字段中添加了对主机名和未知端点的支持。

# 历史

从 Redis 版本 4.0.0 开始：添加了节点 ID。
从 Redis 版本 7.0.0 开始：添加了额外的网络元数据字段。

# 反馈

如果您在此页面上发现问题，或有改进建议，请提交请求以合并或打开存储库中的问题。

← Bgrewriteaof Config Set →