Función h3_try_validate

Se aplica a Databricks SQL Databricks Runtime 11.3 LTS y versiones posteriores

Esta función se usa para obtener el valor de entrada, que es del tipo BIGINT o STRING, si este se corresponde con una celda H3 válida. De lo contrario, se obtiene el valor NULL. En el caso de la entrada STRING, se recortan los ceros iniciales.

Sintaxis

h3_try_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

Se devuelve un valor del mismo tipo que el de la expresión h3CellIdExpr e igual al valor de la expresión de entrada h3CellIdExpr. De manera alternativa, se devuelve el valor NULL. En el caso de la entrada STRING, se recortan los ceros iniciales.

La función devuelve NULL si la entrada es NULL. La función también puede devolver el valor NULL para las entradas que no sean NULL.

Ejemplos

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

Funciones relacionadas

• h3_isvalid Función
• h3_validate Función