Condividi tramite

Funzione h3_stringtoh3

  • Articolo

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

Converte la stringa di input, che dovrebbe essere una stringa esadecimale che rappresenta una cella H3, nella rappresentazione BIGINT corrispondente della cella H3.

Sintassi

h3_stringtoh3 ( h3CellIdExpr )

Argomenti

  • h3CellIdStringExpr: espressione STRING esadecimale ben formata che rappresenta un ID cella H3 valido.

Valori restituiti

Valore di tipo BIGINT. Il valore restituito è la rappresentazione BIGINT della stringa esadecimale di input.

La funzione restituisce NULL se l'input è NULL. La funzione converte la stringa esadecimale nel numero BIGINT corrispondente. 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 il valore di h3CellIdStringExpr non può essere convertito in bigint o se il valore corrisponde a un valore BIGINT minore 0x08001fffffffffff o maggiore di 0x08ff3b6db6db6db6, la funzione restituisce H3_INVALID_CELL_ID.

Esempi

-- Simple example
> SELECT h3_stringtoh3('85283473fffffff')
  599686042433355775

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