カテゴリ：

集計関数 （カーディナリティ推定）、 ウィンドウ関数

HLL

HyperLogLog を使用して、入力の異なるカーディナリティの近似値を返します（ HLL(col1, col2, ... ) は COUNT(DISTINCT col1, col2, ... ) の近似値を返します）。

HyperLogLog の詳細については、 異なる値の数の推定 をご参照ください。

エイリアス:

APPROX_COUNT_DISTINCT。

こちらもご参照ください。

HLL_ACCUMULATE 、 HLL_COMBINE 、 HLL_ESTIMATE

構文

集計関数

HLL( [ DISTINCT ] <expr1> [ , ... ] )

HLL(*)

ウィンドウ関数

HLL( [ DISTINCT ] <expr1> [ , ... ] ) OVER ( [ PARTITION BY <expr2> ] )

HLL(*) OVER ( [ PARTITION BY <expr2> ] )

引数

expr1

これは、個別の値の数を知るときの式です。

expr2

これは、行をパーティションにグループ化するために使用されるオプションの式です。

戻り値

戻り値のデータ型はINTEGERです。

使用上の注意

• DISTINCT は引数として含めることができますが、効果はありません。

• NULL 値と集計関数の詳細については、 集計関数と NULL 値 をご参照ください。

• ウィンドウ関数として使用する場合、

  • この関数は次をサポートしていません。

    • OVER（）句のORDER BY サブ句。

    • ウィンドウフレーム。

例

This example shows how to use HLL and its alias APPROX_COUNT_DISTINCT. This example calls both COUNT(DISTINCT i) and APPROX_COUNT_DISTINCT(i) to emphasize that the results of these two functions do not always match exactly.

The exact output from the following query might vary because APPROX_COUNT_DISTINCT() returns an approximation, not an exact value.

SELECT COUNT(i), COUNT(DISTINCT i), APPROX_COUNT_DISTINCT(i), HLL(i)
  FROM sequence_demo;
+----------+-------------------+--------------------------+--------+
| COUNT(I) | COUNT(DISTINCT I) | APPROX_COUNT_DISTINCT(I) | HLL(I) |
|----------+-------------------+--------------------------+--------|
|     1024 |              1024 |                     1007 |   1007 |
+----------+-------------------+--------------------------+--------+