

 从补丁 198 开始，Amazon Redshift 将不再支持创建新的 Python UDF。现有的 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`。

 *resolution*   
一个 `INTEGER` 数据类型的值，或一个计算结果为 `INTEGER` 类型的表达式。该值表示 H3 网格系统的分辨率。该值必须是 0-15 之间的整数，包括 0 和 15。`0` 表示最粗糙，`15` 表示最精细。

## 返回类型
<a name="H3_Polyfill-function-return"></a>

`SUPER` – 表示 H3 单元格 ID 的列表。

如果 *geom* 不是 `POLYGON`，则返回一个错误。

如果 *resolution* 超出范围，则返回错误信息。

如果 *geom* 为空，则返回 NULL。

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

下面的 SQL 根据多边形和分辨率 `4` 返回一个 SUPER 数据类型数组，其中包含 H3 单元格 ID。

```
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]
```