- 最新动态
- 功能总览
- 服务公告
- 产品介绍
-
GeminiDB Redis接口
- 产品介绍
- 计费说明
- 快速入门
-
用户指南
- 通过IAM授予使用GeminiDB Redis的权限
- 购买GeminiDB Redis实例
- 实例连接及管理
-
数据迁移
- Redis数据迁移方案概览
- 使用DRS服务将GeminiDB Redis迁移到Redis(推荐)
- 阿里云数据库Redis/Tair到GeminiDB Redis的迁移
- 使用DRS服务将自建Redis或者Redis集群迁移到GeminiDB Redis(推荐)
- 通过Redis-Shake迁移工具将自建Redis迁移到GeminiDB Redis
- 使用Redis-Shake工具将RDB文件/AOF文件 导入到GeminiDB Redis
- 使用数据导入功能将RDB文件恢复到GeminiDB Redis(推荐)
- Kvrocks到GeminiDB Redis的迁移
- Pika到GeminiDB Redis的迁移
- SSDB到GeminiDB Redis的迁移
- LevelDB到GeminiDB Redis的迁移
- RocksDB到GeminiDB Redis的迁移
- AWS ElasticCache for Redis数据库到GeminiDB Redis的迁移
- 迁移后Redis数据一致性校验
- 实例管理
- 变更实例
- 数据备份
- 数据恢复
- 诊断分析
- 账号与安全
- 参数管理
- 日志与审计
- 查看监控指标与配置告警
- GeminiDB Redis标签管理
- GeminiDB Redis用户资源配额
- 通过GeminiDB Redis实现RDS内存加速
- 开发参考
- 最佳实践
- 性能白皮书
-
常见问题
-
产品咨询
- GeminiDB Redis和开源Redis、其他开源Redis云服务有什么区别?
- 和开源Redis相比,GeminiDB Redis性能如何?
- GeminiDB Redis兼容Redis哪些版本,兼容哪些命令,客户端连接是否需要修改
- 自建Redis是否可以搬迁至GeminiDB Redis,需要注意什么
- 什么是GeminiDB Redis实例可用性
- GeminiDB Redis实例总容量是总内存吗,内存和容量之间是什么联系
- 购买GeminiDB Redis实例时,如何选择合适的节点规格和节点数量?
- 购买x GB的GeminiDB Redis的实例,优选主备还是集群?
- GeminiDB Redis持久化机制是怎样的,会丢数据吗
- GeminiDB Redis是否支持布隆过滤器等modules
- 计费相关
-
数据库使用
- scan指定match参数,数据中确实存在匹配的key,为什么返回的是空
- 业务侧原本做了数据分片,切换到GeminiDB Redis后如何处理这部分逻辑
- GeminiDB Redis接口是否支持keys命令的模糊查询
- GeminiDB Redis是否支持多DB
- 对于scan类的操作,GeminiDB Redis接口与开源Redis 5.0的返回值顺序为什么有差异
- 对于scan类的操作,返回的 cursor 为什么数字很大,与开源Redis不一样?
- 针对某些不合法命令,GeminiDB Redis接口与开源Redis 5.0的报错信息为什么有差异
- 如何处理报错:CROSSSLOT Keys in request don't hash to the same slot
- GeminiDB Redis单次事务推荐包含的命令条数
- GeminiDB Redis集群版实例中,哪些命令需要使用hashtag
- 如何处理报错“ERR unknown command sentinel"
- 对于阻塞命令,GeminiDB Redis接口(主备实例)与开源Redis的返回值为什么可能有差异
- GeminiDB Redis存储扩容需要多久,对业务有影响吗?
- GeminiDB Redis多个节点同时扩容需要多长时间,对业务影响如何?
- GeminiDB Redis规格变更包含的在线变更和离线变更有什么区别,通常需要多长时间,对业务有哪些影响?
- GeminiDB Redis版本补丁升级包含的在线升级和离线升级有什么区别,通常需要多长时间,对业务有哪些影响?
- GeminiDB Redis备份文件是否可以下载到本地,是否支持线下恢复数据
- GeminiDB Redis数据备份工作机制是怎样的,对业务有哪些影响?
- 购买GeminiDB Redis 1U*2节点特惠型实例后,业务访问量比较少,但CPU占用率比较高,是什么原因?
- GeminiDB Redis监控面板上key数量下降又恢复至正常数量是什么原因?
- GeminiDB Redis节点CPU偶发冲高,可能是哪些原因
- key数量统计是什么机制?迁移完成后,GeminiDB监控中key数量不准,还在持续增长,是什么原因?
- 数据库连接
- 备份与恢复
- 区域和可用区
-
数据迁移
- 报错ERR the worker queue is full, and the request cannot be excecuted
- 报错ERR the request queue of io thread is full, and the request cannot be excecuted
- 报错 read error, please check source redis log or network
- 报错 slaveping_thread.cc-ThreadMain-90: error: Ping master error
- 同步状态正向迁移速度太慢
- 同步状态正向迁移速度太快,报错:ERR server reply timeout, some responses may lose, but requests have been executed
- 4.0、5.0以及6.2版本的自建Redis能迁移至GeminiDB Redis吗?
- 自建Redis主备、集群实例如何迁移到GeminiDB Redis?
- 为什么阿里云Redis、腾讯云Redis等云服务不能使用DRS进行数据迁移?
- 自建主备Redis,迁移到GeminiDB Redis集群,需要考虑哪些因素?
- 迁移完成后数据量变少了,100GB的数据迁移到GeminiDB Redis只有20-30GB,数据是不是没迁移完?
- 内存加速
- 资源冻结/释放/删除/退订
-
产品咨询
-
GeminiDB Influx接口
- 产品介绍
- 计费说明
- 快速入门
-
用户指南
- 通过IAM授予使用GeminiDB Influx的权限
- 购买GeminiDB Influx实例
- 实例连接及管理
- 数据迁移
- 数据转Parquet格式并导出至OBS设置
- 实例生命周期管理
- 变更实例
- 数据库命令
- 冷热分离
- 证书管理
- 数据备份
- 数据恢复
- 参数管理
- 日志与审计
- 查看监控指标与配置告警
- GeminiDB Influx标签管理
- GeminiDB Influx用户资源配额
- 最佳实践
- 性能白皮书
- 常见问题
-
GeminiDB Cassandra接口
- 产品介绍
- 计费说明
- 快速入门
-
用户指南
- 通过IAM授予使用GeminiDB Cassandra的权限
- 购买GeminiDB Cassandra实例
- 实例连接及管理
- 数据迁移
- 实例生命周期管理
- 变更实例
- 同城容灾
- 异地双活
- 数据备份
- 数据恢复
- 参数管理
- 日志与审计
- 查看监控指标与配置告警
- 企业项目
- GeminiDB Cassandra标签管理
- GeminiDB Cassandra用户资源配额
- 最佳实践
- 性能白皮书
- 常见问题
- GeminiDB (兼容DynamoDB API)实例
- HBase协议兼容版实例
- GeminiDB Mongo接口
- 技术白皮书
- SDK参考
-
API参考
- 使用前必读
- API概览
- 如何调用API
- 快速入门
- API v3.1(推荐)
-
API v3(推荐)
- 查询API版本
- 接口版本和规格
-
实例管理
- 创建实例
- 删除实例
- 查询实例列表和详情
- 扩容实例存储容量
- 扩容实例的节点数量
- 缩容实例的节点数量
- 获取节点会话列表
- 查询实例节点会话统计信息
- 关闭实例节点会话
- 查询实例可变更规格
- 变更实例规格
- 修改实例的管理员密码
- 修改实例名称
- 变更实例安全组
- 数据库补丁升级
- 批量数据库补丁升级
- 创建冷数据存储
- 扩容冷数据存储
- 绑定/解绑弹性公网IP
- 切换实例SSL开关
- 重启实例或者节点
- 设置磁盘自动扩容策略
- 修改数据库端口
- 判断弱密码
- 修改副本集跨网段访问配置
- 删除扩容失败的节点
- 查询创建实例或扩容节点时需要的IP数量
- 查询磁盘自动扩容策略
- 变更实例存储容量
- 查询高危命令
- 修改高危命令
- 查询Redis实例的热key
- 设置Redis禁用命令
- 查询Redis禁用命令
- 删除Redis禁用命令
- 设置实例可维护时间段
- Redis主备切换
- 支持节点的开关机
- 查询GeminiDB Redis实例的大key
- 获取GeminiDB Redis的免密配置
- 支持修改GeminiDB Redis的免密配置
- 查询内存加速映射列表和详情
- 创建内存加速规则
- 解除内存加速映射
- 创建内存加速映射
- 修改内存加速规则
- 查询内存加速规则列表和详情
- 删除内存加速规则
- 开启/关闭实例数据导出
- 开启/关闭秒级监控
- 查询秒级监控配置
- 连接管理
- 备份与恢复
- 参数模板管理
- 管理数据库和账号
- 标签管理
- 日志管理
- 配额管理
- 容灾管理
- 任务管理
- 企业项目管理
- 实例负载均衡管理
- 历史API
- 权限策略和授权项
- 附录
- 视频帮助
- 通用参考
链接复制成功!
GeminiDB Redis集群版实例中,哪些命令需要使用hashtag
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场景会有内存增加、访问变慢的风险,不推荐使用。