Compartir vía

Función h3_validate

  • Artículo

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

Devuelve el valor de entrada, que es del tipo BIGINT o STRING, si corresponde a un identificador de celda H3 válido o, de lo contrario, emite un error. En el caso de la entrada STRING, se recortan los ceros iniciales.

Sintaxis

h3_validate ( h3CellIdExpr )

Argumentos

  • h3CellIdExpr: expresión BIGINT o una expresión STRING que se espera que represente un identificador de celda H3 válido.

Devoluciones

Valor del mismo tipo que el tipo de la expresión h3CellIdExpr y igual al valor de la expresión de entrada h3CellIdExpr. En el caso de la entrada STRING, se recortan los ceros iniciales.

La función devuelve NULL si la entrada es NULL.

Condiciones de error

  • Si h3CellIdExpr no es un identificador de celda H3 válido, la función devuelve H3_INVALID_CELL_ID.

Ejemplos

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