H3_TRY_GRID_PATH

H3_TRY_GRID_PATH

두 셀 사이의 선을 나타내는 H3 셀 ID가 담긴 VARIANT 값 배열을 반환하려고 시도할 때 오류가 발생하면 NULL을 반환하는 H3_GRID_PATH의 특수 버전이에요.

출처: Snowflake SQL Reference - H3_TRY_GRID_PATH

본문

구문

H3_TRY_GRID_PATH( <cell_id_1> , <cell_id_2> )

인자

cell_id_1

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

cell_id_2

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

반환 값

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

  • 계산에 성공하면 cell_id_1과 cell_id_2로 지정한 셀 사이의 선을 나타내는 H3 셀 ID가 담긴 VARIANT 값 배열을 반환해요. ID의 형식에 대한 정보는 H3_GRID_PATH를 참고하세요.
  • 선을 계산할 수 없으면(예: 두 셀이 서로 이웃하지 않은 베이스 셀에 속한 경우) 오류를 보고하지 않고 NULL을 반환해요.

사용 시 참고 사항

사용 시 참고 사항은 H3_GRID_PATH를 참고하세요.

예시

다음 예시는 두 셀 사이의 선 반환을 시도해요. 두 셀이 서로 이웃하지 않은 베이스 셀에 속하기 때문에 함수는 선 반환에 실패하고 NULL을 반환해요.

SELECT H3_TRY_GRID_PATH('813d7ffffffffff', '81343ffffffffff');

+--------------------------------------------------------+
| H3_TRY_GRID_PATH('813D7FFFFFFFFFF', '81343FFFFFFFFFF') |
|--------------------------------------------------------|
| NULL                                                   |
+--------------------------------------------------------+

두 H3 셀 사이의 경로를 성공적으로 계산하는 예시는 H3_GRID_PATH를 참고하세요.

더 알아보기