HSCAN

迭代哈希的字段和值。

语法

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

引入版本：2.8.0

复杂度摘要：O(1)

有关 HSCAN 文档，请参阅 SCAN。

必需参数

key

保存哈希值的键的名称。

cursor

光标值。使用 0 开始迭代，然后使用每次调用返回的游标作为下一次调用的参数。

可选参数

MATCH pattern

仅返回名称与给定的 glob 样式模式匹配的字段。

COUNT count

每次迭代返回的字段数量的提示。默认值为 10。

NOVALUES

仅返回字段名称，不返回其值。

Redis Software 与 Redis Cloud 兼容性

Redis 软件	Redis Cloud	说明
✅ 标准 ✅ 主动-主动	✅ 标准 ✅ 主动-主动

返回值

RESP2

数组回复：二元素数组。 * 第一个元素是 批量字符串回复，表示无符号 64 位数字，即游标。 * 第二个元素是已扫描的字段/值对的 数组回复。当使用 NOVALUES 标志（自 Redis 7.4 起）时，仅返回字段名称。

RESP3

数组回复：二元素数组。 * 第一个元素是 批量字符串回复，表示无符号 64 位数字，即游标。 * 第二个元素是已扫描的字段/值对的 数组回复。当使用 NOVALUES 标志（自 Redis 7.4 起）时，仅返回字段名称。

资料来源：Redis 官方 HSCAN 文档；中文内容参考 Redis 文档许可。