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')
限制
- 只支持
key =与key in, 不支持 and 组合. - 固定按 score 升序, 不支持倒序(ZREVRANGE)与下标范围.
- 默认 limit 10000; 不支持 group by / order by(请在外层 SQL 中完成).
- key 不是 zset 类型时返回”数据类型错误”.
相关文档: redis_set / redis-dao / dynamicSourceWrite