跳到主要内容

HSCAN

说明

官方文档:HSCAN

按游标读取一批字段和值。

语法

HSCAN key cursor [MATCH pattern] [COUNT count] [NOVALUES]

cursor 首次传 0MATCH 按字段名过滤,COUNT 是扫描工作量提示,NOVALUES 只返回字段名(需要 Redis 7.4+)。

返回结果

返回形式行数内容
结果集多行CURSOR 字段,STRING 类型
FIELD 字段,STRING 类型
VALUE 字段,STRING 类型(不使用 NOVALUES 时)
注意

当前游标附在每条结果行上,空批次无法读取后续游标。需要保证完整遍历时使用 Redis 客户端;不要把空批次当作遍历完成。

示例

HSET demo:user name mali age 18
HSCAN demo:user 0 MATCH n* COUNT 10