CLUSTER KEYSLOT

返回键的哈希槽。

语法

CLUSTER KEYSLOT key

引入版本：3.0.0

复杂度摘要：O(N)

返回一个整数，标识指定键哈希到的哈希槽。该命令主要用于调试和测试，因为它通过 API 公开哈希算法的底层 Redis 实现。此命令的示例用例：

  1. 客户端库可以使用 Redis 来测试自己的哈希算法，生成随机键并使用本地实现和 Redis CLUSTER KEYSLOT 命令对它们进行哈希处理，然后检查结果是否相同。
  2. 人们可以使用此命令来检查哈希槽是什么，然后检查负责给定键的关联 Redis 集群节点。

该命令使用完整的 Redis集群哈希算法，包括对哈希标签的支持。如果某个键包含有效的哈希标签，Redis 将仅对 { 和 } 之间的键部分进行哈希处理。您可以使用哈希标签将多个键强制放入同一哈希槽中，以便它们由同一节点处理。

必需参数

key

用于计算哈希槽的键名称。

示例

> CLUSTER KEYSLOT somekey
(integer) 11058
> CLUSTER KEYSLOT foo{hash_tag}
(integer) 2515
> CLUSTER KEYSLOT bar{hash_tag}
(integer) 2515

Redis Software 与 Redis Cloud 兼容性

Redis
软件		 Redis
Cloud		 说明
✅ 标准
✅ 主动-主动		 ✅ 标准
✅ 主动-主动		 仅支持 OSS集群API。

返回值

RESP2

整数回复：指定key的哈希槽号

RESP3

整数回复：指定key的哈希槽号

资料来源：Redis 官方 CLUSTER KEYSLOT 文档；中文内容参考 Redis 文档许可。