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

Функция h3_h3tostring

  • Статья

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

Преобразует идентификатор входной ячейки H3 в эквивалентное шестнадцатеричное строковое представление.

Синтаксис

h3_h3tostring ( h3CellIdExpr )

Аргументы

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

Возвраты

Значение типа STRING. Возвращенный результат — это шестнадцатеричное представление входного значения BIGINT с опущенными начальными нулями.

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

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

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

Примеры

-- Simple example
> SELECT h3_h3tostring(599686042433355775)
  85283473fffffff

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