Поделиться через

Функция h3_try_validate

  • Статья

Область применения: флажок Databricks SQL флажок Databricks Runtime 11.3 LTS и выше

Возвращает входное значение типа BIGINT или STRING, если оно соответствует допустимой ячейке H3, в противном случае возвращается NULL. В случае ввода строкового значения все начальные нули обрезаются.

Синтаксис

h3_try_validate ( h3CellIdExpr )

Аргументы

  • h3CellIdExpr: выражение BIGINT или строковое выражение, которое должно представлять допустимый идентификатор ячейки H3.

Возвраты

Значение того же типа, что и тип выражения h3CellIdExpr, равное значению входного выражения h3CellIdExpr или NULL. В случае ввода строкового значения все начальные нули обрезаются.

Функция возвращает значение 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