Delen via

h3_try_validate-functie

  • Artikel

Van toepassing op: vinkje als ja aan Databricks SQL vinkje als ja aan Databricks Runtime 11.3 LTS en hoger

Retourneert de invoerwaarde, die van het type BIGINT of STRING is, als deze overeenkomt met een geldige H3-cel of anderszins NULL. In het geval van STRING-invoer worden eventuele voorloopnullen ingekort.

Syntaxis

h3_try_validate ( h3CellIdExpr )

Argumenten

  • h3CellIdExpr: een BIGINT-expressie of een TEKENREEKSexpressie die naar verwachting een geldige H3-cel-id vertegenwoordigt.

Retouren

Een waarde van hetzelfde type als het type expressie h3CellIdExpr , en gelijk aan de waarde van de invoerexpressie h3CellIdExpr of NULL. In het geval van STRING-invoer worden eventuele voorloopnullen ingekort.

De functie retourneert NULL als de invoer NULL is. De functie kan NULL retourneren voor niet-NULL-invoer.

Voorbeelden

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