文档首页> 数据仓库服务 GaussDB(DWS)> 8.1.3推荐版> 函数和操作符> HLL函数和操作符> 功能函数
更新时间：2024-03-06 GMT+08:00
查看PDF

功能函数

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)
父主题： HLL函数和操作符