

 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/)。

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

# H3\$1Polyfill
<a name="H3_Polyfill-function"></a>

H3\$1Polyfill 會傳回對應於指定解析度之輸入多邊形中包含的六邊形和五邊形的對應 H3 儲存格 ID。如需 H3 索引的詳細資訊，請參閱 [H3](spatial-terminology.md#spatial-terminology-h3)。

## 語法
<a name="H3_Polyfill-function-syntax"></a>

```
H3_Polyfill(geom, resolution)
```

## 引數
<a name="H3_Polyfill-function-arguments"></a>

 *geom*   
`GEOMETRY` 資料類型的值，或是評估為 `GEOMETRY` 類型的表達式。*geom* 必須是 `POLYGON`。

 *解析度*   
`INTEGER` 資料類型的值，或是評估為 `INTEGER` 類型的表達式。該值表示 H3 網格系統的解析度。該值必須是介於 0 和 15 之間的整數。`0` 是最普遍的，`15` 是最好。

## 傳回類型
<a name="H3_Polyfill-function-return"></a>

`SUPER`— 代表 H3 儲存格 ID 的清單。

如果 *geom* 不是 `POLYGON`，則會傳回錯誤。

如果*解析度*超出範圍，則會傳回錯誤。

如果 *geom* 為空白，則會傳回 NULL。

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

下方的 SQL 會從多邊形和解析度 `4` 傳回 H3 儲存格 ID 的 SUPER 資料類型陣列。

```
SELECT H3_Polyfill(ST_GeomFromText('POLYGON((0 0, 0 1, 1 1, 1 0, 0 0))'), 4);
```

```
 h3_polyfill
----------------------------------------------------------------------------------------------------------------------------------------------------------
 [596538848238895103,596538805289222143,596538856828829695,596538813879156735,596537920525959167,596538685030137855,596538693620072447,596538839648960511]
```