H3_CELL_TO_PARENT

H3_CELL_TO_PARENT

주어진 해상도에서 H3 셀의 부모 셀 ID를 반환해요. 입력 ID로 INTEGER 값을 주면 INTEGER 값으로, 16진수 ID를 주면 16진수 ID가 담긴 VARCHAR로 반환해요.

출처: Snowflake SQL Reference - H3_CELL_TO_PARENT

본문

구문

H3_CELL_TO_PARENT( <cell_id> , <target_resolution> )

인자

cell_id

  • H3 셀 ID(인덱스)를 나타내는 INTEGER, 또는 16진수 형식의 셀 ID를 나타내는 VARCHAR예요.

target_resolution

  • 반환할 H3 셀에 사용할 H3 해상도를 지정하는 0 이상 15 이하의 INTEGER예요. 이 범위 밖의 다른 INTEGER 값을 지정하면 오류가 발생해요.

반환 값

지정한 대상 해상도의 H3 부모 셀 ID를 반환해요. ID의 형식은 다음과 같아요.

  • cell_id가 INTEGER 값이면 ID를 INTEGER 값으로 반환해요.
  • cell_id가 16진수 ID가 담긴 VARCHAR 값이면 16진수 ID를 VARCHAR 값으로 반환해요.

예시

다음 예시는 ID가 613036919424548863인 H3 셀(INTEGER 값으로 지정)의 부모 셀에 대한 H3 셀 ID를 반환해요.

SELECT H3_CELL_TO_PARENT(613036919424548863, 7);

+------------------------------------------+
| H3_CELL_TO_PARENT(613036919424548863, 7) |
|------------------------------------------|
|                       608533319805566975 |
+------------------------------------------+

다음 예시는 ID가 881F1D4887FFFFF인 H3 셀(VARCHAR 값으로 지정)의 부모 셀에 대한 H3 셀 ID를 반환해요.

SELECT H3_CELL_TO_PARENT('881F1D4887FFFFF', 7);

+-----------------------------------------+
| H3_CELL_TO_PARENT('881F1D4887FFFFF', 7) |
|-----------------------------------------|
|  871F1D488FFFFFF                        |
+-----------------------------------------+

더 알아보기