h3_stringtoh3-functie

  • Artikel

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

Converteert de invoertekenreeks, die naar verwachting een hexadecimale tekenreeks is die een H3-cel vertegenwoordigt, naar de bijbehorende BIGINT-weergave van de H3-cel.

Syntaxis

h3_stringtoh3 ( h3CellIdExpr )

Argumenten

  • h3CellIdStringExpr: Een goed gevormde hexadecimale TEKENREEKSexpressie die een geldige H3-cel-id vertegenwoordigt.

Retouren

Een waarde van het type BIGINT. De geretourneerde waarde is de BIGINT-weergave van de hexadecimale invoertekenreeks.

De functie retourneert NULL als de invoer NULL is. De functie converteert de hexadecimale tekenreeks naar het bijbehorende BIGINT-getal. De functie voert gedeeltelijke validatie uit met betrekking tot of het invoerargument een geldige H3-cel-id is. Een noodzakelijke, maar niet voldoende voorwaarde voor een geldige H3-id is dat de waarde tussen 0x08001fffffffffff en 0x08ff3b6db6db6db6. Het gedrag van de functie is niet gedefinieerd als de invoercel-id geen geldige cel-id is.

Foutvoorwaarden

  • Als de waarde niet h3CellIdStringExpr kan worden geconverteerd naar een BIGINT of als de waarde overeenkomt met een BIGINT-waarde die kleiner is dan 0x08001fffffffffff of groter 0x08ff3b6db6db6db6is, retourneert de functie H3_INVALID_CELL_ID.

Voorbeelden

-- Simple example
> SELECT h3_stringtoh3('85283473fffffff')
  599686042433355775

-- Input is an invalid H3 cell ID.
> SELECT h3_stringtoh3('0')
  [H3_INVALID_CELL_ID] 0 is not a valid H3 cell ID