Freigeben über


h3_h3tostring-Funktion

Gilt für: Häkchen ja Databricks SQL Häkchen gesetzt ja Databricks Runtime 11.3 LTS und höher

Konvertiert die eingegebene H3-Zellen-ID in die entsprechende hexadezimale String-Darstellung.

Syntax

h3_h3tostring ( h3CellIdExpr )

Argumente

  • h3CellIdExpr: Ein BIGINT-Ausdruck, der eine H3-Zellen-ID darstellt.

Gibt zurück

Ein Wert vom Typ STRING. Das zurückgegebene Ergebnis ist die Big-Endian-Hexadezimaldarstellung der Eingabe BIGINT, wobei alle führenden Nullen entfernt wurden.

Die Funktion gibt NULL zurück, wenn die Eingabe NULL ist. Die Funktion wandelt BIGINT in den entsprechenden hexadezimalen String um. Die Funktion überprüft teilweise, ob das Eingabeargument eine gültige H3-Zellen-ID ist. Eine notwendige, aber nicht hinreichende Bedingung für eine gültige H3-ID ist, dass ihr Wert zwischen 0x08001fffffffffff und 0x08ff3b6db6db6db6 liegt. Das Verhalten der Funktion ist undefiniert, wenn die Eingabezellen-ID keine gültige Zellen-ID ist.

Fehlerbedingungen

  • Wenn der Wert von h3CellIdExpr kleiner als 0x08001fffffffffff oder größer als 0x08ff3b6db6db6db6 ist, gibt die Funktion H3_INVALID_RESOLUTION_VALUE zurück.

Beispiele

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