Condividi tramite

Funzione h3_ispentagon

  • Articolo

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

Restituisce true se l'input BIGINT o STRING esadecimale corrisponde o meno a una cella H3 pentagonale.

Sintassi

h3_ispentagon ( h3CellIdExpr )

Argomenti

  • h3CellIdExpr: espressione BIGINT o espressione STRING esadecimale che rappresenta un ID cella H3.

Valori restituiti

Valore BOOLEAN che indica se l'input BIGINT o STRING esadecimale corrisponde a una cella H3 pentagonale.

La funzione restituisce NULL se l'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.

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.

Esempi

-- Simple example taking a long as input.
> SELECT h3_ispentagon(590112357393367039)
  true

-- Simple example taking a hexadecimal string as input.
> SELECT h3_ispentagon('85283473fffffff')
  false

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