翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# HLL\$1SKETCH\$1AGG 関数
<a name="HLL_SKETCH_AGG"></a>

HLL\$1SKETCH\$1AGG 集計関数は、指定された列の値から HLL スケッチを作成します。入力式の値をカプセル化する HLLSKETCH データ型を返します。

HLL\$1SKETCH\$1AGG 集計関数は任意のデータ型で動作し、NULL 値を無視します。

テーブルに行がない場合、またはすべての行が NULL の場合、結果のスケッチには `{"version":1,"logm":15,"sparse":{"indices":[],"values":[]}}` などのインデックスと値のペアがありません。

## 構文
<a name="HLL_SKETCH_AGG-synopsis"></a>

```
HLL_SKETCH_AGG (aggregate_expression[, lgConfigK ] )
```

## 引数
<a name="HLL_SKETCH_AGG-argument"></a>

 *aggregate\$1expression*   
一意のカウントが発生する INT、BIGINT、STRING、または BINARY 型の式。`NULL` 値はすべて無視されます。

*lgConfigK*  
デフォルトの 12 を含む、4 から 21 までのオプションの INT 定数。K の log-base-2。ここで、K はスケッチのバケットまたはスロットの数です。

## 戻り型
<a name="HLL_SKETCH_AGG-return-type"></a>

HLL\$1SKETCH\$1AGG 関数は、集計グループ内のすべての入力値を消費および集計したために計算された HyperLogLog スケッチを含む NULL 以外の BINARY バッファを返します。

## 例
<a name="HLL_SKETCH_AGG-examples"></a>

次の例では、HyperLogLog (HLL) アルゴリズムを使用して、 `col` 列の値の個別の数を推定します。`hll_sketch_agg(col, 12)` 関数は col 列の値を集計し、精度 12 を使用して HLL スケッチを作成します。次に、 `hll_sketch_estimate()`関数を使用して、生成された HLL スケッチに基づいて個別の値のカウントを推定します。クエリの最終結果は 3 で、`col`列の値の推定個別数を表します。この場合、個別の値は 1、2、3 です。

```
SELECT hll_sketch_estimate(hll_sketch_agg(col, 12))
    FROM VALUES (1), (1), (2), (2), (3) tab(col);
  3
```

次の例では、HLL アルゴリズムを使用して`col`列の値の個別の数を推定しますが、HLL スケッチの精度値は指定しません。この場合、デフォルトの精度である 14 が使用されます。`hll_sketch_agg(col)` 関数は `col`列の値を取得し、HyperLogLog (HLL) スケッチを作成します。これは、要素の個別の数を推定するために使用できるコンパクトなデータ構造です。`hll_sketch_estimate(hll_sketch_agg(col))` 関数は、前のステップで作成した HLL スケッチを取得し、 `col` 列の値の個別の数の推定値を計算します。クエリの最終結果は 3 で、`col`列の値の推定個別数を表します。この場合、個別の値は 1、2、3 です。

```
SELECT hll_sketch_estimate(hll_sketch_agg(col))
FROM VALUES (1), (1), (2), (2), (3) tab(col);
3
```