H3_TRY_COVERAGE_STRINGS

H3_TRY_COVERAGE_STRINGS

H3_TRY_COVERAGE_STRINGS() 함수는 도형(shape, GEOGRAPHY 객체로 지정)을 완전히 덮는 최소 H3 셀 집합을 식별하는 16진수 ID 배열(VARCHAR 값)을 반환하려고 시도하다가 오류가 발생하면 NULL을 반환하는 H3_COVERAGE_STRINGS의 특별 버전이에요.

출처: Snowflake SQL Reference

본문

문법

H3_TRY_COVERAGE_STRINGS( <geography_expression> , <target_resolution> )

인자

  • geography_expression — 덮을 도형 GEOGRAPHY 객체예요.
  • target_resolution — 대상 해상도예요.

반환

VARCHAR 값 배열 또는 NULL을 반환해요.

  • 계산을 성공적으로 수행할 수 있으면, 지정한 입력 도형을 완전히 덮는 최소 H3 셀 집합의 16진수 ID에 대한 VARCHAR 값 배열을 반환해요.
  • 계산을 성공적으로 수행할 수 없으면 오류를 보고하지 않고 NULL을 반환해요.

사용 메모

사용 메모는 H3_COVERAGE_STRINGS를 참고하세요.

예제

다음 예제는 도형(지정된 GEOGRAPHY 객체)을 완전히 덮는 최소 H3 셀 집합을 식별하는 ID 배열을 반환하려고 시도해요. 주어진 해상도에서 주어진 육각형을 덮는 셀 배열이 허용된 크기 제한을 초과하므로 이 함수는 NULL을 반환해요.

SELECT H3_TRY_COVERAGE_STRINGS(
  TO_GEOGRAPHY('POLYGON((-108.959 40.948,
                         -109.015 37.077,
                         -102.117 36.956,
                         -102.134 40.953,
                         -108.959 40.948))'
              ), 15) AS set_of_h3_cells_covering_polygon;
+----------------------------------+
| SET_OF_H3_CELLS_COVERING_POLYGON |
|----------------------------------|
| NULL                             |
+----------------------------------+

ID 배열을 성공적으로 반환하는 예제는 H3_COVERAGE_STRINGS를 참고하세요.

더 알아보기