Compartir vía

Función h3_stringtoh3

  • Artículo

Se aplica a: casilla marcada como sí Databricks SQL casilla marcada como Sí Databricks Runtime 11.3 LTS y versiones posteriores

Convierte la cadena de entrada, que se espera que sea una cadena hexadecimal que represente una celda H3, en la representación BIGINT correspondiente de la celda H3.

Sintaxis

h3_stringtoh3 ( h3CellIdExpr )

Argumentos

  • h3CellIdStringExpr: expresión STRING hexadecimal bien formada que representa un identificador de celda H3 válido.

Devoluciones

Valor de tipo BIGINT. El valor devuelto es la representación BIGINT de la cadena hexadecimal de entrada.

La función devuelve NULL si la entrada es NULL. La función convierte la cadena hexadecimal en el número BIGINT correspondiente. La función realiza una validación parcial con respecto a si el argumento de entrada es un identificador de celda H3 válido. Una condición necesaria, pero no suficiente para un identificador H3 válido es que su valor está entre 0x08001fffffffffff y 0x08ff3b6db6db6db6. El comportamiento de la función no está definido si el identificador de celda de entrada no es un identificador de celda válido.

Condiciones de error

  • Si el valor de h3CellIdStringExpr no se puede convertir en BIGINT o corresponde a un valor BIGINT menor que 0x08001fffffffffff o mayor que 0x08ff3b6db6db6db6, la función devuelve H3_INVALID_CELL_ID.

Ejemplos

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