H3_UNCOMPACT_CELLS_STRINGS

H3_UNCOMPACT_CELLS_STRINGS

입력의 H3 셀들과 같은 영역을 덮는, 지정한 해상도의 H3 셀들의 VARCHAR 16진수 ID가 담긴 VARIANT 값 배열을 반환해요.

출처: Snowflake SQL Reference - H3_UNCOMPACT_CELLS_STRINGS

본문

구문

H3_UNCOMPACT_CELLS_STRINGS( <array_of_cell_ids> , <target_resolution> )

인자

array_of_cell_ids

  • H3 셀 ID(인덱스)를 나타내는 VARCHAR 16진수 값이 담긴 VARIANT 값 배열이에요.

target_resolution

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

반환 값

ARRAY 데이터 타입 값 또는 NULL을 반환해요.

  • 입력이 VARCHAR 16진수 값이 담긴 VARIANT 값 배열이면, 지정한 해상도의 H3 셀 집합을 나타내는 VARCHAR 16진수 값이 담긴 VARIANT 값 배열을 반환해요.
  • 입력이 NULL이면 오류를 보고하지 않고 NULL을 반환해요.

사용 시 참고 사항

  • 입력의 모든 VARCHAR 16진수 값은 유효한 H3 셀을 나타내야 해요.
  • 입력 셀은 target_resolution 인자에 지정한 해상도보다 높은 해상도를 가질 수 없어요.

예시

다음 예시는 유효한 H3 셀 ID를 나타내는 셀들에 대해 대상 해상도 10의 비압축(고해상도) 셀 집합을 반환해요.

SELECT H3_UNCOMPACT_CELLS_STRINGS(
  [
    '8a2a1072339ffff',
    '892a1072377ffff'
  ],
  10
) AS uncompacted;

+----------------------+
| UNCOMPACTED          |
|----------------------|
| [                    |
|   "8a2a1072339ffff", |
|   "8a2a10723747fff", |
|   "8a2a1072374ffff", |
|   "8a2a10723757fff", |
|   "8a2a1072375ffff", |
|   "8a2a10723767fff", |
|   "8a2a1072376ffff", |
|   "8a2a10723777fff"  |
| ]                    |
+----------------------+

더 알아보기