H3_ToParent - Amazon Redshift
構文引数戻り型例

Amazon Redshift は、2025 年 11 月 1 日以降、新しい Python UDF の作成をサポートしなくなります。Python UDF を使用する場合は、その日付より前に UDF を作成してください。既存の Python UDF は引き続き通常どおり機能します。詳細については、ブログ記事を参照してください。

H3_ToParent

H3_ToParent は、特定の H3 インデックスの指定された親解像度で親 H3 セル ID を返します。H3 インデックスの詳細については、「H3」を参照してください。

構文

H3_ToParent(index, resolution)

引数

インデックス

H3 セルのインデックスを表すデータ型 BIGINT または VARCHAR の値、またはこれらのデータ型のいずれかに評価される式。

resolution

データ型 INTEGER の値または INTEGER 型と評価される式の値。この値は親セル ID の解像度を表します。値は 0 からインデックスの解像度まで (両端の数値を含む) である必要があります。

戻り型

BIGINT — 親の H3 セル ID を表します。

インデックスまたは解像度が NULL の場合、NULL が返されます。

index が有効でない場合、エラーが返されます。

解像度が 0 未満またはインデックスの解像度より大きい場合、エラーが返されます。

例

次の 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