Redis ZSCAN 命令
Redis ZSCAN 命令用于迭代有序集合中的元素(包括元素成员和元素分值)
( Redis >= 2.8.0 )
语法
Redis ZSCAN 命令语法如下:
127.0.0.1:6379> ZSCAN key cursor [MATCH pattern] [COUNT count]
-
cursor 参数。ZSCAN 命令每次被调用之后, 都会向用户返回一个新的游标, 用户在下次迭代时需要使用这个新游标作为 ZSCAN 命令的游标参数, 以此来延续之前的迭代过程。
当 SCAN 命令的游标参数被设置为 0 时, 服务器将开始一次新的迭代, 而当服务器向用户返回值为 0 的游标时, 表示迭代已结束 -
count 参数。虽然增量式迭代命令不保证每次迭代所返回的元素数量, 但我们可以使用 COUNT 选项, 对命令的行为进行一定程度上的调整。 基本上, COUNT 选项的作用就是让用户告知迭代命令, 在每次迭代中应该从数据集里返回多少元素
-
MATCH 参数。 和 KEYS 命令一样, 增量式迭代命令也可以通过提供一个 glob 风格的模式参数, 让命令只返回和给定模式相匹配的元素, 这一点可以通过在执行增量式迭代命令时, 通过给定 MATCH <pattern> 参数来实现
count 参数的默认值为 10
返回值
返回的每个元素都是一个有序集合元素,一个有序集合元素由一个成员(member)和一个分值(score)组成。
范例
127.0.0.1:6379> FLUSHALL OK 127.0.0.1:6379> ZADD site 8 "twle.cn" 7 "www.twle.cn" 2 "baidu.com" 3 "qq.com" (integer) 4 127.0.0.1:6379> ZSCAN site 0 match "t*" 1) "0" 2) 1) "twle.cn" 2) "8"