H3_ToParent - Amazon Redshift
语法参数返回类型示例

从 2025 年 11 月 1 日起，Amazon Redshift 将不再支持创建新的 Python UDF。如果您想要使用 Python UDF，请在该日期之前创建 UDF。现有的 Python UDF 将继续正常运行。有关更多信息，请参阅博客文章。

H3_ToParent

H3_ToParent 返回给定 H3 索引在指定父单元格分辨率下的父 H3 单元格 ID。有关 H3 索引的信息，请参阅H3。

语法

H3_ToParent(index, resolution)

参数

索引

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

resolution

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

返回类型

BIGINT：表示父 H3 单元格 ID。

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

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

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

示例

以下 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