Partager via


Fonction h3_h3tostring

S’applique à : coche marquée oui Databricks SQL oui coché Databricks Runtime 11.3 LTS et versions ultérieures

Convertit l’ID de cellule H3 d’entrée en sa représentation sous forme de chaîne hexadécimale équivalente.

Syntaxe

h3_h3tostring ( h3CellIdExpr )

Arguments

  • h3CellIdExpr : expression BIGINT représentant un ID de cellule H3.

Retours

Valeur de type CHAÎNE. Le résultat retourné correspond à la représentation hexadécimale big-endian de l’entrée BIGINT avec tous les zéros non significatifs supprimés.

La fonction retourne NULL si l’entrée est NULL. La fonction convertit le BIGINT en chaîne hexadécimale correspondante. La fonction effectue une validation partielle pour déterminer si l’argument d’entrée est un ID de cellule H3 valide. Une valeur d’ID H3 comprise entre 0x08001fffffffffff et 0x08ff3b6db6db6db6 constitue une condition nécessaire mais pas suffisante. Le comportement de la fonction n’est pas défini si l’ID de cellule d’entrée ne correspond pas à un ID de cellule valide.

Conditions d'erreur

  • Si la valeur de h3CellIdExpr est inférieure à 0x08001fffffffffff ou supérieure à 0x08ff3b6db6db6db6, la fonction retourne H3_INVALID_CELL_ID.

Exemples

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