本文导读

展开导读

文档首页/ 云数据库 GeminiDB/ GeminiDB Redis接口/ 常见问题/ 数据库使用/ GeminiDB Redis集群版实例中，哪些命令需要使用hashtag

GeminiDB Redis集群版实例中，哪些命令需要使用hashtag

更新时间：2025-04-24 GMT+08:00

查看PDF

Hashtag简介及使用方法

相较于单机/主备单分片多key命令的使用，原生Cluster集群多key命令的使用需要遵循hashtag机制，将包含相同hashtag的key分配到相同的哈希槽上（hash slot），以确保多key命令操作的原子性和性能，否则会返回报错“CROSSSLOT Keys in request don't hash to the same slot”。Hashtag使用规则如下：

1. 基本格式

hashtag 用 {} 包裹：只有 {} 内的内容会参与哈希槽计算。

例如：{user:1000}.profile 和 {user:1000}.settings 的 hashtag 都是 user:1000，因此它们会被分配到同一个哈希槽。

2. 位置规则

{} 可以出现在键的任何位置：

例如：foo{user:1000}bar 的 hashtag 仍然是 user:1000。

只有第一个 {} 有效：

如果键中有多个 {}，只有第一个 {} 的内容会被用作 hashtag。

例如：{user:1000}.{profile} 的 hashtag 是 user:1000，而 profile 会被忽略。

3. 使用场景

事务操作：在Redis集群中，事务（MULTI/EXEC）要求所有涉及的键必须在同一个节点上。通过 hashtag 可以确保这些键被分配到同一个哈希槽。
Lua 脚本：Lua 脚本中的键也需要位于同一节点，hashtag 可以保证这一点。

多key操作：如String（mset、mget）、List（blpop、brpop、brpoplpush、rpoplpush）、Set（sdiff、sdiffstore、sinter、sinterstore、sintercard、sunion、sunionstore）、Zset（zinter、zinterstore、zintercard、zunion、zunionstore、zdiff、zdiffstore、zrangestore）、Key管理（del、exists、unlink、touch、rename、renamenx、sort）、Stream（xread、xreadgroup）、bitop等操作。

集群使用示例：

1. 字符串String: mset / mget

设置多个键（用户数据）

mset {user:1000}:name "Alice" {user:1000}:email "alice@example.com" {user:1000}:age 30

获取多个键

mget {user:1000}:name {user:1000}:email {user:1000}:age

2. 事务操作：MULTI/EXEC

开启事务

MULTI
SET {order:1234}:status "processing"
EXPIRE {order:1234}:status 3600
EXEC

3. Lua脚本：

脚本减少库存并记录日志

EVAL "redis.call('DECR', KEYS[1]); redis.call('SET', KEYS[2], 'updated')" 2 {product:100}:stock {product:100}:log

GeminiDB Redis Proxy集群支持的拆分命令

相较于原生Cluster集群，Proxy集群承担着命令转发、负载均衡和故障转移等职责，可以简化客户使用逻辑，无需过多关注分片管理，同时支持多DB等高级功能。Proxy集群兼容单机、哨兵、Cluster接入方式，推荐使用Proxy集群架构。

与原生Cluster集群相比，Proxy集群支持部分多key命令拆分，分配到不同的后端节点进行处理，完成后在Proxy上进行聚合再返回客户端，简化了多key命令使用逻辑。GeminiDB Redis Proxy集群支持拆分命令如下：

Key管理相关：del、exists、unlink、touch
String：mget、mset
Set: sdiff、sdiffstore、sinter、sinterstore、sintercard、sunion、sunionstore
Zset: zinter、zinterstore、zintercard、zunion、zunionstore、zdiff、zdiffstore、zrangestore
支持对事务中多个命令的拆分；如果事务中包含了不支持拆分的多 key 命令，这些命令涉及的 key 需要添加 hashtag。

其他命令则不支持拆分，推荐在集群中使用hashtag，以保证多key命令操作的原子性和性能。其中Key管理及string多key命令，相比Set和Zset更为轻量级，在shard执行后，在Proxy简单聚合即返回客户端；而Set和Zset的多key命令，需要将每个key读入到Proxy再进行相关的逻辑操作，大key场景会有内存增加、访问变慢的风险，不推荐使用。

父主题：数据库使用

上一篇：GeminiDB Redis单次事务推荐包含的命令条数

下一篇：如何处理报错“ERR unknown command sentinel"

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消