Udostępnij za pośrednictwem

Funkcja h3_minchild

  • Artykuł

Zwraca element podrzędny minimalnej wartości wejściowej komórki H3 w określonej rozdzielczości.

Dotyczy: zaznacz pole wyboru oznaczone jako tak Databricks SQL preview zaznacz pole wyboru oznaczone jako tak Databricks Runtime 11.3 LTS i nowsze

Składnia

h3_minchild ( h3cellIdExpr, resolutionExpr )

Argumenty

  • h3CellIdExpr: wyrażenie BIGINT lub wyrażenie szesnastkowe STRING reprezentujące identyfikator komórki H3.
  • resolutionExpr : Wyrażenie INT, którego wartość ma być między h3_resolution(h3CellIdExpr) i 15 inkluzywna, określając rozdzielczość podrzędnego identyfikatora komórki H3.

Zwraca

Wartość tego samego typu co typ h3CellIdExpr wyrażenia, odpowiadająca podrzędniu minimalnej wartości wejściowego identyfikatora komórki H3 w określonej rozdzielczości.

Funkcja zwraca wartość NULL, jeśli dowolne z dwóch wyrażeń wejściowych ma wartość NULL. Funkcja wykonuje częściową walidację dotyczącą tego, czy argument wejściowy jest prawidłowym identyfikatorem komórki H3. Wymagany, ale nie wystarczający warunek prawidłowego identyfikatora H3 jest taki, że jego wartość mieści się między 0x08001fffffffffff i 0x08ff3b6db6db6db6. Zachowanie funkcji jest niezdefiniowane, jeśli identyfikator komórki wejściowej nie jest prawidłowym identyfikatorem komórki. Jeśli wartość resolutionExpr elementu jest równa rozdzielczości wejściowego identyfikatora komórki H3, zwracany jest wejściowy identyfikator komórki H3.

Warunki błędu

  • Jeśli h3CellIdExpr jest ciągiem, którego nie można przekonwertować na BIGINT lub odpowiada wartości BIGINT, która jest mniejsza lub większa niż 0x08001fffffffffff 0x08ff3b6db6db6db6, funkcja zwraca H3_INVALID_CELL_ID.
  • Jeśli resolutionExpr funkcja jest mniejsza lub większa niż 15h3_resolution(h3CellIdExpr) , funkcja zwraca H3_INVALID_RESOLUTION_VALUE.

Przykłady

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

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

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

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