Partage via

Fonction h3_ischildof

  • Article

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

Retourne true si la première cellule H3 est identique ou un enfant de celle-ci.

Syntaxe

h3_ischildof ( h3CellId1Expr, h3cellId2Expr )

Arguments

  • h3CellId1Expr : expression BIGINT ou expression STRING hexadécimale représentant un ID de cellule H3.
  • h3CellId2Expr : expression BIGINT ou expression STRING hexadécimale représentant un ID de cellule H3.

Retours

Valeur de type BOOLEAN indiquant si la première cellule H3 est identique ou un enfant de la deuxième cellule H3.

La fonction retourne NULL si l’une des entrées est NULL. La fonction effectue une validation partielle pour déterminer si l’un des deux arguments d’entrée est un ID de cellule H3 valide ou non. 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’un des deux ID de cellule d’entrée ne correspond pas à un ID de cellule valide.

Conditions d'erreur

  • Si h3CellId1Expr ou h3CellId2Expr correspond à une STRING qui ne peut pas être convertie en BIGINT ou qui correspond à une valeur BIGINT inférieure à 0x08001fffffffffff ou supérieure à 0x08ff3b6db6db6db6, la fonction retourne H3_INVALID_CELL_ID.

Exemples

-- Simple example taking two longs as input.
> SELECT h3_ischildof(608693241318998015, 599686042433355775)
  true

-- Simple example taking two strings as input.
> SELECT h3_ischildof('88283471b9fffff', '85283473fffffff')
  true

-- Simple example taking a long integer and a string as input.
> SELECT h3_ischildof(580260664489017343, '85283473fffffff')
  false

-- First input is an invalid H3 cell ID.
> SELECT h3_ischildof(0, 599686042433355775)
  [H3_INVALID_CELL_ID] 0 is not a valid H3 cell ID

-- Second input is an invalid H3 cell ID.
> SELECT h3_ischildof(608693241318998015, 'xyz')
  [H3_INVALID_CELL_ID] 'xyz' is not a valid H3 cell ID