Redis SCAN 命令

Redis key(鍵)

Redis Scan 命令用于迭代數(shù)據(jù)庫中的數(shù)據(jù)庫鍵。

SCAN 命令是一個基于游標的迭代器，每次被調用之后， 都會向用戶返回一個新的游標， 用戶在下次迭代時需要使用這個新游標作為 SCAN 命令的游標參數(shù)， 以此來延續(xù)之前的迭代過程。

SCAN 返回一個包含兩個元素的數(shù)組， 第一個元素是用于進行下一次迭代的新游標， 而第二個元素則是一個數(shù)組， 這個數(shù)組中包含了所有被迭代的元素。如果新游標返回 0 表示迭代已結束。

相關命令：

• SSCAN 命令用于迭代集合鍵中的元素。
• HSCAN 命令用于迭代哈希鍵中的鍵值對。
• ZSCAN 命令用于迭代有序集合中的元素（包括元素成員和元素分值）。

語法

redis Scan 命令基本語法如下：

SCAN cursor [MATCH pattern] [COUNT count]

• cursor - 游標。
• pattern - 匹配的模式。
• count - 指定從數(shù)據(jù)集里返回多少元素，默認值為 10 。

可用版本

>= 2.8.0

返回值

數(shù)組列表。

在線示例

使用 SCAN 命令迭代：

redis 127.0.0.1:6379> scan 0   # 使用 0 作為游標，開始新的迭代
1) "17"                        # 第一次迭代時返回的游標
2)  1) "key:12"
    2) "key:8"
    3) "key:4"
    4) "key:14"
    5) "key:16"
    6) "key:17"
    7) "key:15"
    8) "key:10"
    9) "key:3"
   10) "key:7"
   11) "key:1"
redis 127.0.0.1:6379> scan 17  # 使用的是第一次迭代時返回的游標 17 開始新的迭代
1) "0"
2) 1) "key:5"
   2) "key:18"
   3) "key:0"
   4) "key:2"
   5) "key:19"
   6) "key:13"
   7) "key:6"
   8) "key:9"
   9) "key:11"

Redis key(鍵)