从补丁 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\$1ToParent
<a name="H3_ToParent-function"></a>

H3\$1ToParent 返回给定 H3 索引在指定父单元格分辨率下的父 H3 单元格 ID。有关 H3 索引的信息，请参阅[H3](spatial-terminology.md#spatial-terminology-h3)。

## 语法
<a name="H3_ToParent-function-syntax"></a>

```
H3_ToParent(index, resolution)
```

## 参数
<a name="H3_ToParent-function-arguments"></a>

 * 索引*   
一个 `BIGINT` 或 `VARCHAR` 数据类型的值，该值表示 H3 单元格的索引；或一个计算结果为这两种数据类型之一的表达式。

 *resolution*   
一个 `INTEGER` 数据类型的值，或一个计算结果为 `INTEGER` 类型的表达式。该值表示父单元格 ID 的分辨率。该值必须在 0 与 *index* 的分辨率（含）之间。

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

`BIGINT`：表示父 H3 单元格 ID。

如果 *index* 或 *resolution* 为 NULL，则返回 NULL。

如果 *index* 无效，则返回一个错误。

如果 *resolution* 小于 0 或大于 *index* 的分辨率，则返回一个错误。

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

以下 SQL 输入一个表示 H3 单元格的索引的 VARCHAR 和一个表示所需父单元格的所需分辨率的 INTEGER，并返回一个表示输入 H3 单元格分辨率 0 下的父单元格的 BIGINT。

```
SELECT H3_ToParent('85283473fffffff', 0);
```

```
 h3_toparent
--------------------
 577199624117288959
```

以下 SQL 输入一个表示 H3 单元格的索引的 BIGINT 和一个表示所需父单元格的所需分辨率的 INTEGER，并返回一个表示输入 H3 单元格分辨率 0 下的父单元格的 BIGINT。

```
SELECT H3_ToParent(646078419604526808, 8);
```

```
 h3_toparent
--------------------
 614553222213795839
```