Partager via


Fonction h3_validate

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 à un ID de cellule H3 valide, ou émet une erreur 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_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. 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.

Conditions d'erreur

  • Si h3CellIdExpr ne correspond pas à un ID de cellule H3 valide, la fonction retourne H3_INVALID_CELL_ID.

Exemples

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

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

-- Example taking a long as input that is not a valid H3 cell ID.
> SELECT h3_validate(599686042433355776)
  [H3_INVALID_CELL_ID] 599686042433355776 is not a valid H3 cell ID

-- Example where the input is an invalid hexadecimal string.
> SELECT h3_validate('I am not an H3 cell id')
  [H3_INVALID_CELL_ID] 'I am not an H3 cell id' is not a valid H3 cell ID