ZSCAN
命令在 Redis 中用于迭代有序集合(sorted set)中的元素
ZSCAN
命令的基本語法如下:
ZSCAN <key> [MATCH pattern] [COUNT count]
參數說明:
<key>
:有序集合的鍵名。MATCH pattern
(可選):用于匹配集合中的元素的模式。可以使用通配符 *
和 ?
。COUNT count
(可選):指定每次迭代返回的元素數量。默認值為 10。ZSCAN
命令返回兩個值:游標的當前值(cursor)和一個包含當前迭代結果的數組。游標用于在后續迭代中繼續掃描集合。
下面是一個使用 ZSCAN
命令的示例:
127.0.0.1:6379> ZADD my_sorted_set 1 "one" 2 "two" 3 "three" 4 "four" 5 "five"
(integer) 6
127.0.0.1:6379> ZSCAN my_sorted_set 0 MATCH "two" COUNT 1
1) "1"
2) 1) "two"
2) (integer) 5
在這個示例中,我們首先使用 ZADD
命令向有序集合 my_sorted_set
中添加了一些元素。然后,我們使用 ZSCAN
命令迭代集合中的元素,并使用 MATCH
參數匹配包含 “two” 的元素。最后,我們打印出每次迭代的游標和結果。
注意:在使用 ZSCAN
命令時,建議將游標值傳遞給下一次 ZSCAN
調用,以便繼續迭代。這樣可以避免重復掃描整個集合。