Condividi tramite

Funzione h3_h3tostring

  • Articolo

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

Converte l'ID cella H3 di input nella rappresentazione di stringa esadecimale equivalente.

Sintassi

h3_h3tostring ( h3CellIdExpr )

Argomenti

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

Valori restituiti

Valore di tipo STRING. Il risultato restituito è la rappresentazione esadecimale big-endian dell'input BIGINT con eventuali zeri iniziali rimossi.

La funzione restituisce NULL se l'input è NULL. La funzione converte bigINT nella stringa esadecimale 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 h3CellIdExpr è minore 0x08001fffffffffff o maggiore di 0x08ff3b6db6db6db6, la funzione restituisce H3_INVALID_CELL_ID.

Esempi

-- Simple example
> SELECT h3_h3tostring(599686042433355775)
  85283473fffffff

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