

 Amazon Redshift 將不再支援從修補程式 198 開始建立新的 Python UDFs。現有 Python UDF 將繼續正常運作至 2026 年 6 月 30 日。如需詳細資訊，請參閱[部落格文章](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/)。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# HLL\$1CREATE\$1SKETCH 函數
<a name="r_HLL_CREATE_SKETCH"></a>

HLL\$1CREATE\$1SKETCH 函數傳回封裝輸入運算式值的 HLLSKETCH 資料類型。HLL\$1CREATE\$1SKETCH 函數適用於任何資料類型，並忽略 NULL 值。如果表格中沒有列或所有列都為 NULL，則產生的草圖沒有索引-值對，例如 `{"version":1,"logm":15,"sparse":{"indices":[],"values":[]}}`。

## 語法
<a name="r_HLL_CREATE_SKETCH-synopsis"></a>

```
HLL_CREATE_SKETCH (aggregate_expression)
```

## 引數
<a name="r_HLL_CREATE_SKETCH-argument"></a>

 *aggregate\$1expression*   
提供要彙總之值的任何有效運算式，例如欄名。NULL 值將被忽略。此函數支援除 HLLSKETCH、GEOMETRY、GEOGRAPHY 和 VARBYTE 以外的任何資料類型作為輸入。

## 傳回類型
<a name="r_HLL_CREATE_SKETCH-return-type"></a>

HLL\$1CREATE\$1SKETCH 函數會傳回 HLLSKETCH 值。

## 範例
<a name="r_HLL_CREATE_SKETCH-examples"></a>

下列範例會傳回資料表 `a_table` 中資料欄 `an_int` 的 HLLSKETCH 類型。JSON 物件用於匯入、匯出或列印草圖時表示稀疏的 HyperLogLog 草圖。字串表示 (Base64 格式) 用於表示密集的 HyperLogLog 草圖。

```
CREATE TABLE a_table(an_int INT);
INSERT INTO a_table VALUES (1), (2), (3), (4);

SELECT hll_create_sketch(an_int) AS sketch FROM a_table;
sketch
-------------------------------------------------------------------------------------------------------
{"version":1,"logm":15,"sparse":{"indices":[20812342,20850007,22362299,47158030],"values":[1,2,1,1]}}
(1 row)
```