Funzione h3_validate

Si applica a: Databricks SQL Databricks Runtime 11.3 LTS e versioni successive

Restituisce il valore di input, di tipo BIGINT o STRING, se corrisponde a un ID di cella H3 valido o genera un errore in caso contrario. Nel caso dell'input STRING, tutti gli zeri iniziali vengono tagliati.

Sintassi

h3_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 . Nel caso dell'input STRING, tutti gli zeri iniziali vengono tagliati.

La funzione restituisce NULL se l'input è NULL.

Condizioni di errore

• Se h3CellIdExpr non è un ID cella H3 valido, la funzione restituisce H3_INVALID_CELL_ID.

Esempi

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

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

-- Example taking a long as input that is not a valid H3 cell ID.
> SELECT h3_validate(599686042433355776);
  [H3_INVALID_CELL_ID] 599686042433355776 is not a valid H3 cell ID

-- Example where the input is an invalid hexadecimal string.
> SELECT h3_validate('I am not an H3 cell id');
  [H3_INVALID_CELL_ID] 'I am not an H3 cell id' is not a valid H3 cell ID

Funzioni correlate

• h3_isvalid Funzione
• h3_try_validate Funzione