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

Функция h3_stringtoh3

  • Статья

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

Преобразует входную строку, которая, как ожидается, будет шестнадцатеричной строкой, представляющей ячейку H3, в соответствующее представление BIGINT ячейки H3.

Синтаксис

h3_stringtoh3 ( h3CellIdExpr )

Аргументы

  • h3CellIdStringExpr: правильно сформированное шестнадцатеричное строковое выражение, представляющее допустимый идентификатор ячейки H3.

Возвраты

Значение типа BIGINT. Возвращаемое значение представляет собой представление BIGINT входной шестнадцатеричной строки.

Функция возвращает значение NULL, если входные данные равны NULL. Функция преобразует шестнадцатеричную строку в соответствующее число BIGINT. Функция выполняет частичную проверку, является ли входной аргумент действительным идентификатором ячейки H3. Необходимое, но недостаточное условие для допустимого идентификатора H3 заключается в том, что его значение находится в диапазоне от 0x08001fffffffffff до 0x08ff3b6db6db6db6. Поведение функции не определено, если идентификатор входной ячейки не является допустимым идентификатором ячейки.

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

  • Если значение h3CellIdStringExpr невозможно преобразовать в BIGINT или оно соответствует значению BIGINT, которое меньше 0x08001fffffffffff или больше 0x08ff3b6db6db6db6, функция возвращает H3_INVALID_CELL_ID.

Примеры

-- Simple example
> SELECT h3_stringtoh3('85283473fffffff')
  599686042433355775

-- Input is an invalid H3 cell ID.
> SELECT h3_stringtoh3('0')
  [H3_INVALID_CELL_ID] 0 is not a valid H3 cell ID