SCAN

通过游标和模式过滤条件遍历键。

键与过期时间 · 示例已验证

本页覆盖的语法

SCAN cursor MATCH pattern COUNT count

从游标 0 开始,持续使用返回的游标,即使批次为空也要继续,直到游标再次为 0。已验证的遍历即使使用较大的 COUNT 值,也进行了 64 次迭代。

实测示例与返回值

下列请求按顺序执行;每个场景使用空数据库。连接先通过测试密码认证。双引号表示字符串,null 表示空回复,数组按 RESP 顺序展示。

# connection: default
> SET sample value
"OK"
# default: SCAN cursor loop (64 requests)
> SCAN 0 MATCH sam* COUNT 1000
["288230376151711744",[]]
# Continue with each returned cursor until it is "0".
# 62 intermediate replies in the downloadable receipt.
> SCAN 18158513697557839872 MATCH sam* COUNT 1000
["0",[]]
# Combined keys: ["sample"]