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

Функция h3_validate

  • Статья

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

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

Синтаксис

h3_validate ( h3CellIdExpr )

Аргументы

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

Возвраты

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

Функция возвращает значение NULL, если входные данные равны NULL.

Условия ошибок

  • Если h3CellIdExpr является недопустимым идентификатором ячейки H3, функция возвращает 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