Delen via

h3_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, van het type BIGINT of STRING, als deze overeenkomt met een geldige H3-cel-id of een fout verzendt. In het geval van STRING-invoer worden eventuele voorloopnullen ingekort.

Syntaxis

h3_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 . In het geval van STRING-invoer worden eventuele voorloopnullen ingekort.

De functie retourneert NULL als de invoer NULL is.

Foutvoorwaarden

Voorbeelden

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