Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

uniqCombined

View as MarkdownEdit this pageReport an issueSet up docs MCP

uniqCombined

引入版本：v1.1.0

计算不同参数值的近似数量。 该函数会以确定性的方式返回结果 (即不依赖于查询处理顺序) 。

与 uniq 函数相比，uniqCombined 函数：

  • 内存消耗低数倍
  • 计算精度高数倍
  • 通常性能会略低一些。但在某些场景下，uniqCombined 的表现可能优于 uniq，例如在分布式查询中需要通过网络传输大量聚合状态时
实现细节

此函数会先对聚合中的所有参数计算哈希值 (String 使用 64 位哈希，其他类型使用 32 位哈希) ，然后在计算中使用该哈希值。 它结合了三种算法：数组、哈希表，以及带误差修正表的 HyperLogLog：

  • 当不同元素较少时，使用数组
  • 当集合大小进一步增大时，使用哈希表
  • 当元素更多时，使用 HyperLogLog，此时会占用固定大小的内存

语法

uniqCombined(HLL_precision)(x[, ...])
uniqCombined(x[, ...])

参数

  • HLL_precision — 可选。HyperLogLog 中单元数量以 2 为底的对数。默认值为 17，实际占用空间约为 96 KiB (2^17 个单元，每个单元 6 位) 。范围：[12, 20]。UInt8

实参

返回值

返回一个 UInt64 类型的值，表示不同参数值的近似数量。UInt64

示例

基本用法

SELECT uniqCombined(number) FROM numbers(1e6);
┌─uniqCombined(number)─┐
│              1001148 │
└──────────────────────┘

使用自定义精度

SELECT uniqCombined(15)(number) FROM numbers(1e5);
┌─uniqCombined(15)(number)─┐
│                   100768 │
└──────────────────────────┘

另见

Navigation