Sdílet prostřednictvím

Funkce h3_try_validate

  • Článek

Platí pro: zaškrtnutí označeného ano Databricks SQL zaškrtnutí označeného ano 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