Udostępnij za pośrednictwem

Funkcja h3_try_validate

  • Artykuł

Dotyczy: zaznacz pole wyboru oznaczone jako tak Databricks SQL zaznacz pole wyboru oznaczone jako tak Databricks Runtime 11.3 LTS i nowsze

Zwraca wartość wejściową typu BIGINT lub STRING, jeśli odpowiada prawidłowej komórce H3 lub null w inny sposób. W przypadku danych wejściowych STRING wszystkie zera wiodące są przycinane.

Składnia

h3_try_validate ( h3CellIdExpr )

Argumenty

  • h3CellIdExpr: wyrażenie BIGINT lub wyrażenie STRING, które ma reprezentować prawidłowy identyfikator komórki H3.

Zwraca

Wartość tego samego typu co typ h3CellIdExpr wyrażenia i równa wartości wyrażenia wejściowego h3CellIdExpr lub NULL. W przypadku danych wejściowych STRING wszystkie zera wiodące są przycinane.

Funkcja zwraca wartość NULL, jeśli dane wejściowe mają wartość NULL. Funkcja może zwracać wartość NULL dla danych wejściowych innych niż NULL.

Przykłady

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