Share via

A h3_ischildof függvény

  • Cikk

A következőkre vonatkozik:jelölje be az igennel jelölt jelölőnégyzetet Databricks SQL jelölje be az igennel jelölt jelölőnégyzetet Databricks Runtime 11.3 LTS és újabb

Igaz értéket ad vissza, ha az első H3 cella megegyezik a második H3 cella gyermekével vagy gyermekével.

Syntax

h3_ischildof ( h3CellId1Expr, h3cellId2Expr )

Argumentumok

  • h3CellId1Expr: BIGINT-kifejezés vagy H3 cellaazonosítót képviselő hexadecimális SZTRING-kifejezés.
  • h3CellId2Expr: BIGINT-kifejezés vagy H3 cellaazonosítót képviselő hexadecimális SZTRING-kifejezés.

Válaszok

LOGIKAI ÉRTÉK, amely azt jelzi, hogy az első H3 cella megegyezik-e a második H3 cella gyermekével vagy gyermekével.

A függvény NULL értéket ad vissza, ha bármelyik bemenet NULL. A függvény részlegesen ellenőrzi, hogy a két bemeneti argumentum bármelyike érvényes H3 cellaazonosító-e. Egy érvényes H3-azonosító szükséges, de nem megfelelő feltétele, hogy értéke a és a között 0x08001fffffffffff0x08ff3b6db6db6db6legyen. A függvény viselkedése nincs meghatározva, ha a két bemeneti cellaazonosító egyike nem érvényes cellaazonosító.

Hibafeltételek

  • Ha h3CellId1Expr vagy olyan KARAKTERLÁNC, amely nem konvertálható BIGINT-vé, vagy olyan BIGINT-értéknek felel meg, amely kisebb 0x08001fffffffffff vagy nagyobb0x08ff3b6db6db6db6, a függvény H3_INVALID_CELL_ID ad vissza.h3CellId2Expr

Példák

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