h3_h3tostring-functie

Van toepassing op: Databricks SQL Databricks Runtime 11.3 LTS en hoger

Converteert de cel-id van de invoer H3 naar de equivalente hexadecimale tekenreeksweergave.

Syntaxis

h3_h3tostring ( h3CellIdExpr )

Argumenten

• h3CellIdExpr: Een BIGINT-expressie die een H3-cel-id vertegenwoordigt.

Retouren

Een waarde van het type STRING. Het geretourneerde resultaat is de hexadecimale weergave van de big-endiane hexadecimale weergave van de invoer BIGINT met eventuele voorloopnullen die zijn gestript.

De functie retourneert NULL als de invoer NULL is. De functie converteert de BIGINT naar de bijbehorende hexadecimale tekenreeks. 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 kleiner h3CellIdExpr dan of groter 0x08ff3b6db6db6db6is, retourneert de functie H3_INVALID_CELL_ID0x08001fffffffffff.

Voorbeelden

-- Simple example
> SELECT h3_h3tostring(599686042433355775)
  85283473fffffff

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

Gerelateerde functies

• h3_stringtoh3, functie