DIGEST

返回字符串值的 XXH3 哈希值。

语法

DIGEST key

引入版本：8.4.0

复杂度摘要：O(N)

获取以十六进制字符串形式存储在指定键中的值的 哈希摘要。键必须是字符串类型。

必需参数

key

键名称。

示例

> SET key1 "Hello world"
OK
> DIGEST key1
"b6acb9d84a38ff74"

详细说明

哈希摘要{#hash-digest}

哈希摘要是字符串值的固定大小的数字表示形式，使用 XXH3 哈希算法计算。 Redis 使用此哈希摘要进行高效的比较操作，而无需比较完整的字符串内容。您可以将这些哈希摘要与 SET 命令的 IFDEQ 和 IFDNE 选项以及 DELEX 命令的 IFDEQ 和 IFDNE 选项结合使用。

Redis Software 与 Redis Cloud 兼容性

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

返回值

RESP2

以下之一：

• 空批量字符串回复 如果键不存在。
• 简单错误回复 如果键存在但保存的值不是字符串。
• 批量字符串回复 以十六进制字符串形式存储在键中的值的哈希摘要。

RESP3

以下之一：

• 空批量字符串回复 如果键不存在。
• 简单错误回复 如果键存在但保存的值不是字符串。
• 批量字符串回复 以十六进制字符串形式存储在键中的值的哈希摘要。

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