PFADD

将元素添加到 HyperLogLog 键。如果键不存在,则创建该键。

语法

PFADD key [element [element ...]]

引入版本:2.8.9

复杂度摘要:O(1)

将所有元素参数添加到存储在指定为第一个参数的变量名处的 HyperLogLog 数据结构中。

作为此命令的副作用,HyperLogLog 内部可能会更新以反映迄今为止添加的唯一项目数量的不同估计(集合的基数)。

如果执行该命令后HyperLogLog估计的近似基数发生变化,则PFADD返回1,否则返回0。如果指定的键不存在,该命令会自动创建一个空的 HyperLogLog 结构(即指定长度和给定编码的 Redis 字符串)。

调用不带元素而仅变量名有效的命令,如果变量已存在,则不执行任何操作;如果键不存在,则仅创建数据结构(在后一种情况下返回 1)。

有关 HyperLogLog 数据结构的介绍,请查看其 数据结构页 和 PFCOUNT 命令页。

必需参数

key

HyperLogLog 键的名称。

可选参数

element [element ...]

要添加到 HyperLogLog 的一个或多个元素。如果没有元素,该命令仅在键尚不存在时创建该键。

示例

redis> PFADD hll a b c d e f g
(integer) 1
redis> PFCOUNT hll
(integer) 7

Redis Software 与 Redis Cloud 兼容性

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

返回值

RESP2

以下之一: * 整数回复:1(如果至少有一个 HyperLogLog 内部寄存器已更改)。 * 整数回复:如果没有更改 HyperLogLog 内部寄存器,则为 0。

RESP3

以下之一: * 整数回复:1(如果至少有一个 HyperLogLog 内部寄存器已更改)。 * 整数回复:如果没有更改 HyperLogLog 内部寄存器,则为 0。

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