HGETEX

获取给定哈希键的一个或多个字段的值，并可选择设置其过期时间。

语法

HGETEX key [EX seconds | PX milliseconds | EXAT unix-time-seconds | PXAT unix-time-milliseconds | PERSIST] FIELDS numfields field [field ...]

引入版本：8.0.0

复杂度摘要：O(N)

获取给定哈希键的一个或多个字段的值，并可选择设置它们的过期时间或生存时间 (TTL)。

必需参数

key

保存哈希值的键的名称。

FIELDS numfields field [field ...]

要检索的哈希字段。 numfields 是字段的数量，后面跟着这些字段的名称。

可选参数

以下选项修改命令的行为。它们是相互排斥的。

EX seconds

设置指定的过期时间，以秒为单位。

PX milliseconds

设置指定的过期时间，单位为毫秒。

EXAT unix-time-seconds

设置字段过期的指定 Unix 时间（以秒为单位）。

PXAT unix-time-milliseconds

设置字段过期的指定 Unix 时间（以毫秒为单位）。

PERSIST

删除与字段关联的 TTL。

示例

redis> HSET mykey field1 "Hello" field2 "World"
(integer) 2
redis> HGETEX mykey EX 120 FIELDS 1 field1
1) "Hello"
redis> HGETEX mykey EX 100 FIELDS 1 field2
1) "World"
redis> HTTL mykey FIELDS 2 field1 field2
1) (integer) 91
2) (integer) 85
redis> HTTL mykey FIELDS 3 field1 field2 field3
1) (integer) 75
2) (integer) 68
3) (integer) -2
...
redis> HTTL mykey FIELDS 3 field1 field2
1) (integer) -2
2) (integer) -2
redis> HGETALL mykey
(empty array)

Redis Software 与 Redis Cloud 兼容性

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

返回值

RESP2

• 数组回复：与给定字段关联的值列表，其顺序与请求的顺序相同。

RESP3

• 数组回复：与给定字段关联的值列表，其顺序与请求的顺序相同。

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