Sdílet prostřednictvím

Funkce h3_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é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

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