Skip to main content

groupBitmapOr

Introduced in: v20.1.0 Calculates the OR of a bitmap column and returns it’s cardinality. If suffix combinator -State is added, then it returns a bitmap object. This is equivalent to groupBitmapMerge (groupBitmap with the -Merge combinator suffix). Syntax
groupBitmapOr(expr)
groupBitmapOrState(expr)
Arguments Returned value Returns a count of type UInt64, or a bitmap object when using -State. UInt64 Examples Usage example
Query
CREATE TABLE bitmap_column_expr_test2
(
    tag_id String,
    z AggregateFunction(groupBitmap, UInt32)
)
ENGINE = MergeTree
ORDER BY tag_id;

INSERT INTO bitmap_column_expr_test2 VALUES ('tag1', bitmapBuild(cast([1,2,3,4,5,6,7,8,9,10] AS Array(UInt32))));
INSERT INTO bitmap_column_expr_test2 VALUES ('tag2', bitmapBuild(cast([6,7,8,9,10,11,12,13,14,15] AS Array(UInt32))));
INSERT INTO bitmap_column_expr_test2 VALUES ('tag3', bitmapBuild(cast([2,4,6,8,10,12] AS Array(UInt32))));

SELECT groupBitmapOr(z) FROM bitmap_column_expr_test2 WHERE like(tag_id, 'tag%');
Response
┌─groupBitmapOr(z)─┐
│             15   │
└──────────────────┘
Using -State combinator
Query
SELECT arraySort(bitmapToArray(groupBitmapOrState(z))) FROM bitmap_column_expr_test2 WHERE like(tag_id, 'tag%');
Response
┌─arraySort(bitmapToArray(groupBitmapOrState(z)))─┐
│ [1,2,3,4,5,6,7,8,9,10,11,12,13,14,15]           │
└─────────────────────────────────────────────────┘
Last modified on June 8, 2026