Condividi tramite

Funzione h3_ischildof

  • Articolo

Si applica a: segno di spunta sì Databricks SQL segno di spunta sì Databricks Runtime 11.3 LTS e versioni successive

Restituisce true se la prima cella H3 è uguale a o figlio della seconda cella H3.

Sintassi

h3_ischildof ( h3CellId1Expr, h3cellId2Expr )

Argomenti

  • h3CellId1Expr: espressione BIGINT o espressione STRING esadecimale che rappresenta un ID cella H3.
  • h3CellId2Expr: espressione BIGINT o espressione STRING esadecimale che rappresenta un ID cella H3.

Valori restituiti

Valore di tipo BOOLEAN che indica se la prima cella H3 è uguale o figlio della seconda cella H3.

La funzione restituisce NULL se uno degli input è NULL. La funzione esegue una convalida parziale relativa al fatto che uno dei due argomenti di input sia un ID cella H3 valido. Una condizione necessaria, ma non sufficiente per un ID H3 valido è che il relativo valore è compreso tra 0x08001fffffffffff e 0x08ff3b6db6db6db6. Il comportamento della funzione non è definito se uno dei due ID cella di input non è un ID cella valido.

Condizioni di errore

  • Se h3CellId1Expr o h3CellId2Expr è un valore STRING che non può essere convertito in bigint o corrisponde a un valore BIGINT minore 0x08001fffffffffff o maggiore di 0x08ff3b6db6db6db6, la funzione restituisce H3_INVALID_CELL_ID.

Esempi

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