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"]验证范围：本页列出的参数形式、准备步骤和断言。示例不证明未列出的选项或部署模式；请使用自己的数据和客户端运行应用测试。
测试环境与可复现证据
验证时间: 2026-09-21T11:06:06Z · Docker / Linux aarch64 · lavik 0.1.0-beta.1
存储与连接: io_uring · 临时文件、2 个工作线程、单机、明文 TCP、密码认证。此测试不衡量 NVMe 性能。
固定源码: 3955b98d43b312324aa8d52775df52cfb111c0d0
二进制 SHA-256: 8306b37ddf05023f85166a6aa2192b7084757e8defd342b602e6470244aca887
镜像: sha256:af0cfb11b78f184cb6cc49a774a49dc97a8e43a0bd3f4d63d83c8c9ef3282d6e