PFADD
Syntax
PFADD key [element [element ...]]
- Available since:
- 2.8.9
- Time complexity:
- O(1) to add every element.
- ACL categories:
-
@write
,@hyperloglog
,@fast
,
将所有元素参数添加到存储在第一个参数指定的变量名中的HyperLogLog数据结构中。
作为此命令的副作用,HyperLogLog 内部可能会更新,以反映到目前为止添加的唯一项目数量的不同估计(集合的基数)。
如果执行命令后HyperLogLog估计的近似基数发生变化,PFADD
返回1,否则返回0。如果指定的键不存在,该命令会自动创建一个空的HyperLogLog结构(即具有指定长度和给定编码的Redis字符串)。
调用命令时只使用变量名而不带元素是有效的,如果变量已经存在,这将导致不执行任何操作,或者如果键不存在,则只创建数据结构(在后一种情况下返回1)。
有关HyperLogLog数据结构的介绍,请查看PFCOUNT
命令页面。
示例
RESP2/RESP3 回复
以下之一:
- Integer reply:
1
如果至少有一个HyperLogLog内部寄存器被更改。 - Integer reply:
0
如果没有HyperLogLog内部寄存器被更改。