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 文档许可。