Compartir vía

Función h3_ischildof

  • Artículo

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

Devuelve true si la primera celda H3 es igual que la celda H3 o un elemento secundario de la misma.

Sintaxis

h3_ischildof ( h3CellId1Expr, h3cellId2Expr )

Argumentos

  • h3CellId1Expr: expresión BIGINT o expresión STRING hexadecimal que representa un identificador de celda H3.
  • h3CellId2Expr: expresión BIGINT o expresión STRING hexadecimal que representa un identificador de celda H3.

Devoluciones

Valor de tipo BOOLEAN que indica si la primera celda H3 es igual que la segunda celda H3 o un elemento secundario de la misma.

La función devuelve NULL si alguna de las entradas es NULL. La función realiza una validación parcial con respecto a si alguno de los dos argumentos de entrada es un identificador de celda H3 válido o no. 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 cualquiera de los dos identificadores de la celda de entrada no es un identificador de celda válido.

Condiciones de error

  • Si h3CellId1Expr o h3CellId2Expr es una cadena que 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 taking two longs as input.
> SELECT h3_ischildof(608693241318998015, 599686042433355775)
  true

-- Simple example taking two strings as input.
> SELECT h3_ischildof('88283471b9fffff', '85283473fffffff')
  true

-- Simple example taking a long integer and a string as input.
> SELECT h3_ischildof(580260664489017343, '85283473fffffff')
  false

-- First input is an invalid H3 cell ID.
> SELECT h3_ischildof(0, 599686042433355775)
  [H3_INVALID_CELL_ID] 0 is not a valid H3 cell ID

-- Second input is an invalid H3 cell ID.
> SELECT h3_ischildof(608693241318998015, 'xyz')
  [H3_INVALID_CELL_ID] 'xyz' is not a valid H3 cell ID