Clickhouse的bitmap函数

bitmapBuild(array)

从无符号整型（UInt8、UInt32、UInt64等）array构造bitmap

SELECT bitmapBuild([1, 2, 3, 4, 5]) AS res, toTypeName(res)

image.png

bitmapToArray(bitmap)

将bitmap转成整型array

SELECT bitmapToArray(bitmapBuild([1, 2, 3, 4, 5])) AS res

image.png

bitmapSubsetInRange(bitmap, range_start, range_end)

返回bitmap中，range_start到range_end区间内（不包含renge_end）的子集bitmap对象

SELECT bitmapToArray(bitmapSubsetInRange(bitmapBuild([10,11,28,30,31,32,33,100,200,500]), toUInt32(30), toUInt32(200))) AS res

image.png

bitmapSubsetLimit(bitmap, range_start, cardinality_limit)

返回bitmap中，从range_start开始的cardinality_limit个元素组成的子集bitmap对象

SELECT bitmapToArray(bitmapSubsetLimit(bitmapBuild([9,10,11,26,27,30,31,32,33,100,200,500]), toUInt32(30), toUInt32(200))) AS res

image.png

bitmapContains(bitmap, e)

判断指定bitmap中是否存在e元素

SELECT bitmapContains(bitmapBuild([1,5,7,9]), toUInt32(9)) AS res

image.png

bitmapHasAny(bitmap1, bitmap2)

bitmap1中是否包含bitmap2中的元素，只要有一个相同的元素，就返回1，否则返回0.

SELECT bitmapHasAny(bitmapBuild([1,2,3]),bitmapBuild([3,4,5])) AS res

image.png

bitmapHasAll(bitmap,bitmap)

bitmap1中是否全部包含bitmap2中的元素，全部包含就返回1，否则返回0.

SELECT bitmapHasAll(bitmapBuild([1,2,3]),bitmapBuild([3,2])) AS res

image.png

bitmapCardinality(bitmap)

返回bitmap的基数

SELECT bitmapCardinality(bitmapBuild([1, 2, 3, 4, 5])) AS res

image.png

bitmapTransform(bitmap, from_array, to_array)

将bitmap中的元素进行转换，将存在于from_array的元素，一次转换成to_array的对应元素。

SELECT bitmapToArray(bitmapTransform(bitmapBuild([1, 2, 3, 4, 5, 6, 7, 8, 9, 10]), cast([5,999,2] as Array(UInt32)), cast([2,888,20] as Array(UInt32)))) AS res

image.png

上面的例子中，依次将bitmap中，5转成2，999（不存在）转成888，2转成20。因为就bitmap中不存在999，所以新bitmap没有888；因为将5转成2，又将2转成20，所以新bitmap中去掉了5和2元素，新加了20元素

bitmapAnd(bitmap,bitmap)

求两个bitmap的交集

SELECT bitmapToArray(bitmapAnd(bitmapBuild([1,2,3]),bitmapBuild([3,4,5]))) AS res

image.png

bitmapOr(bitmap,bitmap)

求两个bitmap的并集

SELECT bitmapToArray(bitmapOr(bitmapBuild([1,2,3]),bitmapBuild([3,4,5]))) AS res

image.png

bitmapXor(bitmap,bitmap)

求两个bitmap的异或

SELECT bitmapToArray(bitmapXor(bitmapBuild([1,2,3]),bitmapBuild([3,4,5]))) AS res

image.png

bitmapAndnot(bitmap1,bitmap2)

求bitmap1与bitmap2的与非

SELECT bitmapToArray(bitmapAndnot(bitmapBuild([1,2,3]),bitmapBuild([3,4,5]))) AS res

image.png