Partager via

Fonction h3_try_validate

  • Article

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

Retourne la valeur d’entrée, qui est de type BIGINT ou STRING, si elle correspond à une cellule H3 valide, ou NULL si ce n’est pas le cas. Dans le cas d’une entrée STRING, les zéros non significatifs sont supprimés.

Syntaxe

h3_try_validate ( h3CellIdExpr )

Arguments

  • h3CellIdExpr : expression BIGINT ou expression STRING censée représenter un ID de cellule H3 valide.

Retours

Valeur du même type que le type de l’expression h3CellIdExpr et égale à la valeur de l’expression d’entrée h3CellIdExpr ou NULL. Dans le cas d’une entrée STRING, les zéros non significatifs sont supprimés.

La fonction retourne NULL si l’entrée est NULL. La fonction peut retourner NULL pour les entrées non NULL.

Exemples

-- Simple example taking a long as input.
> SELECT h3_try_validate(590112357393367039)
  590112357393367039

-- Simple example taking a hexadecimal string as input.
> SELECT h3_try_validate('85283473fffffff')
  85283473fffffff

-- Simple taking a long as input, that is not a valid H3 cell ID.
> SELECT h3_try_validate(599686042433355776)
  null