首页/数据/数据库速查/ZCARD / ZCOUNT 规模统计
Redis 命令96 条

ZCARD / ZCOUNT 规模统计

ZCARD 返回成员总数,ZCOUNT 返回分数区间内成员数;都是常用的监控与「是否存在」判断入口。

数据库速查数据更新于 2026-10-12

示例

示例
ZCARD board                # 3
ZCOUNT board 150 350       # 分数 150..350 的成员数
ZCOUNT board -inf +inf     # 等于 ZCARD
ZCOUNT board (150 +inf     # 大于 150 的成员数
# 用 ZCOUNT 做滑动窗口限流(时间戳分数):
ZCOUNT rate:u1 ($(( $(date +%s%3N) - 60000 )) +inf)
ZCARDO(1) 总成员数
ZCOUNTO(log N) 区间成员数
场景监控、限流、存在性判断
滑动窗口限流的经典实现:ZREMRANGEBYSCORE 清理过期 + ZADD 当前请求 + ZCARD 判断窗口内数量,用 Lua 保证原子。

易错点

  • 用 ZCARD 判断成员是否存在:应使用 ZSCORE/ZRANK,ZCARD 只统计总量
  • ZCOUNT 区间忘了开区间标记,边界成员被多算

数据来源与参考

  • Redis 官方文档: ZCARD
  • Redis 官方文档: ZCOUNT

相关工具

​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌