Condividi tramite


Funzione h3_try_validate

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

Restituisce il valore di input, di tipo BIGINT o STRING, se corrisponde a una cella H3 valida o NULL in caso contrario. Nel caso dell'input STRING, tutti gli zeri iniziali vengono tagliati.

Sintassi

h3_try_validate ( h3CellIdExpr )

Argomenti

  • h3CellIdExpr: espressione BIGINT o espressione STRING che dovrebbe rappresentare un ID di cella H3 valido.

Valori restituiti

Valore dello stesso tipo del tipo dell'espressione h3CellIdExpr e uguale al valore dell'espressione di input h3CellIdExpr o NULL. Nel caso dell'input STRING, tutti gli zeri iniziali vengono tagliati.

La funzione restituisce NULL se l'input è NULL. La funzione può restituire NULL per gli input non NULL.

Esempi

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

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

-- Simple taking a long as input, that is not a valid H3 cell ID.
> SELECT h3_try_validate(599686042433355776)
  null