Partager via

Fonction h3_stringtoh3

  • Article

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

Convertit la chaîne d’entrée, qui doit être une chaîne hexadécimale représentant une cellule H3, en la représentation BIGINT correspondante de la cellule H3.

Syntaxe

h3_stringtoh3 ( h3CellIdExpr )

Arguments

  • h3CellIdStringExpr : expression STRING hexadécimale bien formée représentant un ID de cellule H3 valide.

Retours

Valeur de type BIGINT. La valeur retournée correspond à la représentation BIGINT de la chaîne hexadécimale d’entrée.

La fonction retourne NULL si l’entrée est NULL. La fonction convertit la chaîne hexadécimale en nombre BIGINT correspondant. 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 h3CellIdStringExpr ne peut pas être convertie en BIGINT ou si la valeur correspond à une valeur BIGINT inférieure à 0x08001fffffffffff ou supérieure à 0x08ff3b6db6db6db6, la fonction retourne H3_INVALID_CELL_ID.

Exemples

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