更新时间:2024-06-29 GMT+08:00

功能函数

hll_print(hll)

描述:打印hll的一些debug参数信息。

返回值类型:cstring

示例:

1
2
3
4
5
SELECT hll_print(hll_empty());
                         hll_print                         
-----------------------------------------------------------
 EMPTY, nregs=2048, nbits=5, expthresh=-1(160), sparseon=1gongne
(1 row)

hll_empty()

描述:创建一个空的hll。

返回值类型:hll

示例:

1
2
3
4
5
SELECT hll_empty();
 hll_empty 
-----------
 \x118b7f
(1 row)

hll_empty(int32 log2m)

描述:创建空的hll并指定参数log2m,取值范围是10到16。

返回值类型: hll

示例:

1
2
3
4
5
SELECT hll_empty(10);
 hll_empty 
-----------
 \x118a7f
(1 row)

hll_empty(int32 log2m, int32 regwidth)

描述:创建空的hll并依次指定参数log2m、regwidth。regwidth取值范围是1到5。

返回值类型: hll

示例:

1
2
3
4
5
SELECT hll_empty(10, 4);
 hll_empty 
-----------
 \x116a7f
(1 row)

hll_empty(int32 log2m, int32 regwidth, int64 expthresh)

描述:创建空的hll并依次指定参数log2m、regwidth、expthresh。expthresh取值范围是-1到7之间的整数。该参数可以用来设置从Explicit模式到Sparse模式的阈值大小。-1表示自动模式,0表示跳过Explicit模式,取1-7表示在基数到达2expthresh时切换模式。

返回值类型:hll

示例:

1
2
3
4
5
SELECT hll_empty(10, 4, 7);
 hll_empty 
-----------
 \x116a48
(1 row)

hll_empty(int32 log2m, int32 regwidth, int64 expthresh, int32 sparseon)

描述:创建空的hll并依次指定参数log2m、regwidth、expthresh、sparseon。sparseon取0或者1。

返回值类型:hll

示例:

1
2
3
4
5
SELECT hll_empty(10,4,7,0);
 hll_empty 
-----------
 \x116a08
(1 row)

hll_add(hll, hll_hashval)

描述:把hll_hashval加入到hll中。

返回值类型:hll

示例:

1
2
3
4
5
SELECT hll_add(hll_empty(), hll_hash_integer(1));
         hll_add          
--------------------------
 \x128b7f8895a3f5af28cafe
(1 row)

hll_add_rev(hll_hashval, hll)

描述:把hll_hashval加入到hll中,和hll_add功能一样,只是参数位置进行了交换。

返回值类型:hll

示例:

1
2
3
4
5
SELECT hll_add_rev(hll_hash_integer(1), hll_empty());
       hll_add_rev        
--------------------------
 \x128b7f8895a3f5af28cafe
(1 row)

hll_eq(hll, hll)

描述:比较两个hll是否相等。

返回值类型:bool

示例:

1
2
3
4
5
SELECT hll_eq(hll_add(hll_empty(), hll_hash_integer(1)), hll_add(hll_empty(), hll_hash_integer(2)));
 hll_eq 
--------
 f
(1 row)

hll_ne(hll, hll)

描述:比较两个hll是否不相等。

返回值类型:bool

示例:

1
2
3
4
5
SELECT hll_ne(hll_add(hll_empty(), hll_hash_integer(1)), hll_add(hll_empty(), hll_hash_integer(2)));
 hll_ne 
--------
 t
(1 row)

hll_cardinality(hll)

描述:计算hll的distinct值。

返回值类型:integer

示例:

1
2
3
4
5
SELECT hll_cardinality(hll_empty() || hll_hash_integer(1));
 hll_cardinality 
-----------------
               1
(1 row)

hll_union(hll, hll)

描述:把两个hll数据结构union成一个。

返回值类型:hll

示例:

1
2
3
4
5
SELECT hll_union(hll_add(hll_empty(), hll_hash_integer(1)), hll_add(hll_empty(), hll_hash_integer(2)));
                hll_union                 
------------------------------------------
 \x128b7f8895a3f5af28cafeda0ce907e4355b60
(1 row)