Redis 基础教程

Redis 命令

Redis 高级教程

Redis 笔记

Redis ZSCAN 命令

Redis 有序集合 Redis 有序集合


ZSCAN 命令用于迭代有序集合中的元素(包括元素成员和元素分值)。

命令格式

ZSCAN key cursor [MATCH pattern] [COUNT count]

可用版本:>=2.8.0

时间复杂度:O(1)为每次调用,O(N)为完整的迭代,N 为 有序集合的基数(成员个数)。

参数说明

  • cursor:ZSCAN 命令每次被调用之后,都会向用户返回一个新的游标,用户在下次迭代时需要使用这个新游标作为 ZSCAN 命令的游标参数,以此来延续之前的迭代过程。当 ZSCAN 命令的游标参数被设置为0时,服务器将开始一次新的迭代,而当服务器向用户返回值为0的游标时,表示迭代已结束。

  • match 参数:和 KEYS 命令一样,增量式迭代命令也可以通过提供一个 glob 风格的模式参数,让命令只返回和给定模式相匹配的元素,这一点可以通过在执行增量式迭代命令时,通过给定 MATCH <pattern> 参数来实现。

  • count 参数:虽然增量式迭代命令不保证每次迭代所返回的元素数量,但我们可以使用 COUNT 选项,对命令的行为进行一定程度上的调整。基本上,COUNT 选项的作用就是让用户告知迭代命令,在每次迭代中应该从数据集里返回多少元素。

count 参数的默认值为 10

命令返回值

返回的每个元素都是一个有序集合元素,一个有序集合元素由一个成员(member)和一个分值(score)组成。

示例

redis> FLUSHALL
OK
redis> ZADD site 8 "tool188.com" 7 "www.tool188.com" 2 "baidu.com" 3 "qq.com"
(integer) 4
redis> ZSCAN site 0  match "t*"
1) "0"
2) 1) "tool188.com"
   2) "8"