H3_COMPACT_CELLS_STRINGS

H3_COMPACT_CELLS_STRINGS

입력의 H3 셀과 같은 영역을 덮는, 더 적고 더 큰 H3 셀의 VARCHAR 16진수 ID를 포함하는 VARIANT 값 배열을 반환해요. 압축된 셀에 대한 자세한 내용은 Indexing을 참고해요.

출처: Snowflake SQL Reference - H3_COMPACT_CELLS_STRINGS

본문

구문

H3_COMPACT_CELLS_STRINGS( <array_of_cell_ids> )

인자

H3 셀 ID(인덱스)를 나타내는 VARCHAR 16진수 값을 포함하는 VARIANT 값 배열이에요.

반환 값

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

  • 입력이 VARCHAR 16진수 값의 배열이면 압축된 H3 셀 집합을 나타내는 VARIANT 값으로 구성된 배열을 반환해요. VARIANT 값은 H3 셀 ID를 나타내는 VARCHAR 16진수 값을 포함해요.
  • 입력이 NULL이면 오류를 보고하지 않고 NULL을 반환해요.

사용상 주의사항

  • 입력의 모든 VARCHAR 16진수 값은 유효한 H3 셀을 나타내야 해요.
  • 입력의 모든 H3 셀은 같은 해상도여야 해요.
  • 입력의 H3 셀은 겹치지 않고 고유한 영역을 덮어야 해요. 중복된 H3 셀은 허용되지 않아요.

예시

다음 예시는 H3 셀 집합을 압축해, 같은 영역을 나타내는 더 낮은 해상도의 셀을 반환해요.

SELECT H3_COMPACT_CELLS_STRINGS(
  [
    '8a2a10705507fff',
    '8a2a1070550ffff',
    '8a2a10705517fff',
    '8a2a1070551ffff',
    '8a2a10705527fff',
    '8a2a1070552ffff',
    '8a2a10705537fff',
    '8a2a10705cdffff'
    ]
  ) AS compacted;

+----------------------+
| COMPACTED            |
|----------------------|
| [                    |
|   "8a2a10705cdffff", |
|   "892a1070553ffff"  |
| ]                    |
+----------------------+

더 알아보기