다음을 통해 공유

h3_try_validate 기능

  • 아티클

적용 대상: 예로 표시된 확인 Databricks SQL 예로 표시된 확인 Databricks Runtime 11.3 LTS 이상

유효한 H3 셀에 해당하는 경우 BIGINT 또는 STRING 형식의 입력 값을 반환하고 그렇지 않으면 NULL을 반환합니다. STRING 입력의 경우 선행 0이 잘립니다.

구문

h3_try_validate ( h3CellIdExpr )

인수

  • h3CellIdExpr: 유효한 H3 셀 ID를 나타낼 것으로 예상되는 BIGINT 식 또는 STRING 식입니다.

반품

h3CellIdExpr 식의 형식과 동일한 형식의 값, 입력 h3CellIdExpr 식의 값 또는 NULL과 같습니다. STRING 입력의 경우 선행 0이 잘립니다.

입력이 NULL이면 함수는 NULL을 반환합니다. 함수는 NULL이 아닌 입력에 대해 NULL을 반환할 수 있습니다.

예제

-- Simple example taking a long as input.
> SELECT h3_try_validate(590112357393367039)
  590112357393367039

-- Simple example taking a hexadecimal string as input.
> SELECT h3_try_validate('85283473fffffff')
  85283473fffffff

-- Simple taking a long as input, that is not a valid H3 cell ID.
> SELECT h3_try_validate(599686042433355776)
  null