uniq

引入版本：v1.1

计算参数中不同值的近似数量。

该函数使用自适应抽样算法。在计算状态中，函数使用最多 65536 个元素哈希值的样本。该算法在 CPU 上非常精确且高效。当查询中包含多个此类函数时，使用 uniq 几乎与使用其他聚合函数一样快。

实现细节

此函数为聚合中的所有参数计算哈希值，然后在计算中使用该哈希值。它使用自适应抽样算法。在计算状态中，函数使用最多 65536 个元素哈希值的样本。该算法在 CPU 上非常精确且高效。当查询中包含多个此类函数时，使用 uniq 几乎与使用其他聚合函数一样快。

提示

我们建议在几乎所有场景中优先使用此函数，而不是其他变体。

语法

uniq(x[, ...])

参数

x — 该函数接受可变数量的参数。Tuple(T) 或 Array(T) 或 Date 或 DateTime 或 String 或 (U)Int* 或 Float* 或 Decimal

返回值

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

示例

用法示例

CREATE TABLE example_table (
    id UInt32,
    category String,
    value Float64
) ENGINE = Memory;

INSERT INTO example_table VALUES
(1, 'A', 10.5),
(2, 'B', 20.3),
(3, 'A', 15.7),
(4, 'C', 8.9),
(5, 'B', 12.1),
(6, 'A', 18.4);

SELECT uniq(category) as unique_categories
FROM example_table;

┌─unique_categories─┐
│                 3 │
└───────────────────┘

多个参数

SELECT uniq(category, value) as unique_combinations
FROM example_table;

┌─unique_combinations─┐
│                   6 │
└─────────────────────┘

另请参阅

uniq​

uniq