다음을 통해 공유

h3_validate 기능

  • 아티클

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

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

구문

h3_validate ( h3CellIdExpr )

인수

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

반품

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

입력이 NULL이면 함수는 NULL을 반환합니다.

오류 조건

  • h3CellIdExpr이 유효한 H3 셀 ID가 아닌 경우 함수는 H3_INVALID_CELL_ID를 반환합니다.

예제

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

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

-- Example taking a long as input that is not a valid H3 cell ID.
> SELECT h3_validate(599686042433355776)
  [H3_INVALID_CELL_ID] 599686042433355776 is not a valid H3 cell ID

-- Example where the input is an invalid hexadecimal string.
> SELECT h3_validate('I am not an H3 cell id')
  [H3_INVALID_CELL_ID] 'I am not an H3 cell id' is not a valid H3 cell ID