Funkce h3_try_validate

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

Vrátí vstupní hodnotu typu BIGINT nebo STRING, pokud odpovídá platné buňce H3 nebo jiné hodnotě NULL. V případě vstupu STRING se oříznou všechny počáteční nuly.

Syntaxe

h3_try_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 nebo NULL. V případě vstupu STRING se oříznou všechny počáteční nuly.

Funkce vrátí hodnotu NULL, pokud je vstup NULL. Funkce může vrátit hodnotu NULL pro vstupy bez hodnoty NULL.

Příklady

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

Související funkce

• h3_isvalid funkce
• h3_validate funkce