Condividi tramite

Funzione h3_tochildren

  • Articolo

Si applica a: segno di spunta sì Databricks SQL segno di spunta sì Databricks Runtime 11.3 LTS e versioni successive

Restituisce una matrice delle celle H3 figlio della cella H3 di input alla risoluzione specificata.

Sintassi

h3_tochildren ( h3cellIdExpr, resolutionExpr )

Argomenti

  • h3CellIdExpr: espressione BIGINT o espressione STRING esadecimale che rappresenta un ID cella H3.
  • resolutionExpr: espressione INT, il cui valore deve essere compreso tra h3_resolution(h3CellIdExpr) e 15 inclusivo, specificando la risoluzione degli ID di cella H3 figlio.

Valori restituiti

MATRICE di valori dello stesso tipo del tipo dell'espressione h3CellIdExpr , corrispondente agli ID di cella H3 figlio della cella H3 di input alla risoluzione specificata.

La funzione restituisce NULL se una delle due espressioni di input è NULL. La funzione esegue la convalida parziale relativa al fatto che l'argomento di input sia un ID cella H3 valido. Una condizione necessaria, ma non sufficiente per un ID H3 valido è che il relativo valore è compreso tra 0x08001fffffffffff e 0x08ff3b6db6db6db6. Il comportamento della funzione non è definito se l'ID cella di input non è un ID cella valido. Se il valore di è uguale alla risoluzione dell'ID cella H3 di resolutionExpr input, la matrice restituita contiene un singolo valore uguale all'ID cella H3 di input.

Condizioni di errore

  • Se h3CellIdExpr è un valore STRING che non può essere convertito in bigint o corrisponde a un valore BIGINT minore o maggiore di 0x08001fffffffffff 0x08ff3b6db6db6db6, la funzione restituisce H3_INVALID_CELL_ID.
  • Se resolutionExpr è minore o maggiore di h3_resolution(h3CellIdExpr) 15, la funzione restituisce H3_INVALID_RESOLUTION_VALUE.

Esempi

-- Simple example taking a long as input.
> SELECT h3_tochildren(599686042433355775, 6)
  [604189641121202175,604189641255419903,604189641389637631,604189641523855359,604189641658073087,604189641792290815,604189641926508543]

-- Simple example taking a hexadecimal string as input.
> SELECT h3_tochildren('85283473fffffff', 6)
  [862834707ffffff,86283470fffffff,862834717ffffff,86283471fffffff,862834727ffffff,86283472fffffff,862834737ffffff]

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

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