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

Функция h3_maxchild

  • Статья

Возвращает дочерний элемент максимального значения входной ячейки H3 в указанном разрешении.

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

Синтаксис

h3_maxchild ( h3cellIdExpr, resolutionExpr )

Аргументы

  • h3CellIdExpr: выражение BIGINT или шестнадцатеричное строковое выражение, представляющее идентификатор ячейки H3.
  • resolutionExpr : выражение INT, значение которого должно находиться между h3_resolution(h3CellIdExpr) и 15 включающими, указывая разрешение дочернего идентификатора ячейки H3.

Возвраты

Значение того же типа, что и тип h3CellIdExpr выражения, соответствующее дочернему значению значения входной ячейки H3 в указанном разрешении.

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

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

  • Если h3CellIdExpr — это строка, которая не может быть преобразована в BIGINT или соответствует значению BIGINT, которое меньше 0x08001fffffffffff или больше 0x08ff3b6db6db6db6, функция возвращает H3_INVALID_CELL_ID.
  • Если значение resolutionExpr меньше h3_resolution(h3CellIdExpr) или больше 15, функция возвращает H3_INVALID_RESOLUTION_VALUE.

Примеры

-- Simple example taking a long as input.
> SELECT h3_maxchild(599686042433355775, 10)
  622204040416821247

-- Simple example taking a valid hexadecimal string as input.
> SELECT h3_maxchild('85283473fffffff', 10)
  8a2834736db7fff

-- First input is an invalid H3 cell ID.
> SELECT h3_maxchild(0, 15)
  [H3_INVALID_CELL_ID] 0 is not a valid H3 cell ID

-- Second input is an invalid resolution value.
> SELECT h3_maxchild('85283473fffffff', 4)
  [H3_INVALID_RESOLUTION_VALUE] H3 resolution 4 must be between 5 and 15, inclusive