sybn sybn-util 项目说明文档 - 基于java的跨数据库联合查询

redis_zset 有序集合表

2026-09-23
sybn

redis_zset 对应 redis 的 zset(有序集合)数据结构, 每个 member 关联一个 score, 结果按 score 升序, 每个成员一行.

等效 DQL

  • 虚拟表 SQL
select * from redis_zset where key = 'z1'
  • 等效 redis 原生命令
ZRANGE z1 0 9999 WITHSCORES

返回字段

字段 类型 说明
key string redis key
value string zset 成员(member), key 不存在时无行
score double 成员对应的分数(按 score 升序)

可查指标

指标 获取方式 说明
member 列表 where key = 'z1' 按 score 升序, 带分数
member 数量 对结果行 count 等于 ZCARD
单个 score 结果中的 score 列 指定 member 的分值
type redis_scan 恒为 zset
ttl redis_scan key 的过期时间

查询示例

-- 查全部 member(默认上限 10000)
select * from redis_zset where key = 'rank:1'

-- limit 限制成员行数
select * from redis_zset where key = 'rank:1' limit 100

-- 批量查
select * from redis_zset where key in ('rank:1', 'rank:2')

限制

  1. 只支持 key = 与 key in, 不支持 and 组合.
  2. 固定按 score 升序, 不支持倒序(ZREVRANGE)与下标范围.
  3. 默认 limit 10000; 不支持 group by / order by(请在外层 SQL 中完成).
  4. key 不是 zset 类型时返回”数据类型错误”.

相关文档: redis_set / redis-dao / dynamicSourceWrite


Similar Posts

Comments

暂不开放评论! 可微信联系