H3_COMPACT_CELLS

H3_COMPACT_CELLS

입력의 H3 셀들과 동일한 영역을 덮는 더 적고 더 큰 H3 셀들의 INTEGER ID를 담은 VARIANT 값 배열을 반환해요. 압축된 셀(compacted cells)에 대한 자세한 내용은 Indexing 문서를 참고해요.

출처: Snowflake H3_COMPACT_CELLS 함수 문서

본문

구문 (Syntax)

H3_COMPACT_CELLS(  )

인자 (Arguments)

  • array_of_cell_ids — H3 셀 ID(인덱스)를 나타내는 INTEGER 값을 담은 VARIANT 값의 배열이에요.

반환 값 (Returns)

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

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

사용 노트 (Usage Notes)

  • 입력의 모든 INTEGER 값은 유효한 H3 셀을 나타내야 해요.
  • 입력의 모든 H3 셀은 동일한 해상도여야 해요.
  • 입력의 H3 셀들은 겹치지 않고 고유한 영역을 덮어야 해요. 중복 H3 셀은 허용되지 않아요.

예제 (Examples)

다음 예제는 H3 셀 집합을 압축하여, 동일한 영역을 나타내는 더 낮은 해상도의 셀을 반환해요.

SELECT H3_COMPACT_CELLS(
  [
    622236750562230271,
    622236750562263039,
    622236750562295807,
    622236750562328575,
    622236750562361343,
    622236750562394111,
    622236750562426879,
    622236750558396415
  ]
) AS compacted;

+-----------------------+
| COMPACTED             |
|-----------------------|
| [                     |
|   622236750558396415, |
|   617733150935089151  |
| ]                     |
+-----------------------+

더 알아보기