跳到主要内容
版本:Latest-3.3

to_bitmap

功能

输入为取值在 0 ~ 18446744073709551615 区间的 unsigned bigint,输出为包含该元素的 bitmap。如果输入值不在该范围内,会返回 NULL。

该函数主要用于 Stream Load 导入时将整型字段导入 StarRocks 表中的 bitmap 字段,如下例:

cat data | curl --location-trusted -u user:passwd -T - \
-H "columns: dt,page,user_id, user_id=to_bitmap(user_id)" \
http://host:8410/api/test/testDb/_stream_load

语法

TO_BITMAP(expr)

参数说明

expr: 支持的数据类型为 unsigned BIGINT。

返回值说明

返回值的数据类型为 BITMAP。

示例

select bitmap_count(to_bitmap(10));
+-----------------------------+
| bitmap_count(to_bitmap(10)) |
+-----------------------------+
| 1 |
+-----------------------------+

select bitmap_to_string(to_bitmap(10));
+---------------------------------+
| bitmap_to_string(to_bitmap(10)) |
+---------------------------------+
| 10 |
+---------------------------------+

select bitmap_to_string(to_bitmap(-5));
+---------------------------------+
| bitmap_to_string(to_bitmap(-5)) |
+---------------------------------+
| NULL |
+---------------------------------+

select bitmap_to_string(to_bitmap(null));
+-----------------------------------+
| bitmap_to_string(to_bitmap(NULL)) |
+-----------------------------------+
| NULL |
+-----------------------------------+