Funkce h3_validate

Platí pro: Databricks SQL Databricks Runtime 11.3 LTS a vyšší

Vrátí vstupní hodnotu typu BIGINT nebo STRING, pokud odpovídá platnému ID buňky H3, nebo vygeneruje chybu jinak. V případě vstupu STRING se oříznou všechny počáteční nuly.

Syntaxe

h3_validate ( h3CellIdExpr )

Argumenty

• h3CellIdExpr: Výraz BIGINT nebo výraz STRING, který má představovat platné ID buňky H3.

Návraty

Hodnota stejného typu jako typ výrazu h3CellIdExpr a rovna hodnotě vstupního h3CellIdExpr výrazu. V případě vstupu STRING se oříznou všechny počáteční nuly.

Funkce vrátí hodnotu NULL, pokud je vstup NULL.

Chybové podmínky

• Pokud h3CellIdExpr není platné ID buňky H3, vrátí funkce H3_INVALID_CELL_ID.

Příklady

-- 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

Související funkce

• h3_isvalid funkce
• h3_try_validate funkce