DUMP

返回存储在键中的值的序列化表示。

语法

DUMP key

引入版本:2.6.0

复杂度摘要:O(1)

以 Redis 特定格式序列化 key 处存储的值并将其返回给用户。可以使用 RESTORE 命令将返回的值合成回 Redis 键。

序列化格式是不透明且非标准的,但它具有一些语义特征:

  • 它包含一个 64 位校验和,用于确保检测到错误。 RESTORE 命令确保在使用序列化值合成键之前检查校验和。
  • 值的编码格式与 RDB 使用的格式相同。
  • RDB版本被编码在序列化值中,这样不同的Redis版本如果RDB格式不兼容,将拒绝处理序列化值。

序列化值不包含过期信息。为了捕获当前值的生存时间,应使用 PTTL 命令。

如果 key 不存在,则返回 nil 批量回复。

必需参数

key

要序列化的键的名称。

示例

> SET mykey 10
OK
> DUMP mykey
"\x00\xc0\n\n\x00n\x9fWE\x0e\xaec\xbb"

Redis Software 与 Redis Cloud 兼容性

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

返回值

RESP2

以下之一: * 批量字符串回复:键的序列化值。 * 无回复:键不存在。

RESP3

以下之一: * 批量字符串回复:键的序列化值。 * 空回复:键不存在。

资料来源:Redis 官方 DUMP 文档;中文内容参考 Redis 文档许可。