Dela via

Funktionen h3_ischildof

  • Artikel

Gäller för: markerad ja Databricks SQL markerad ja Databricks Runtime 11.3 LTS och senare

Returnerar sant om den första H3-cellen är samma som eller ett underordnat till den andra H3-cellen.

Syntax

h3_ischildof ( h3CellId1Expr, h3cellId2Expr )

Argument

  • h3CellId1Expr: Ett BIGINT-uttryck eller ett hexadecimalt STRING-uttryck som representerar ett H3-cell-ID.
  • h3CellId2Expr: Ett BIGINT-uttryck eller ett hexadecimalt STRING-uttryck som representerar ett H3-cell-ID.

Returer

Ett värde av typen BOOLEAN som anger om den första H3-cellen är samma som eller ett underordnat till den andra H3-cellen.

Funktionen returnerar NULL om någon av indata är NULL. Funktionen utför partiell validering av om något av de två indataargumenten är ett giltigt H3-cell-ID. Ett nödvändigt men inte tillräckligt villkor för ett giltigt H3-ID är att dess värde är mellan 0x08001fffffffffff och 0x08ff3b6db6db6db6. Funktionens beteende är odefinierat om något av de två indatacells-ID:na inte är ett giltigt cell-ID.

Feltillstånd

  • Om h3CellId1Expr eller h3CellId2Expr är en STRÄNG som inte kan konverteras till en BIGINT eller motsvarar ett BIGINT-värde som är mindre än eller större än 0x08001fffffffffff 0x08ff3b6db6db6db6returnerar funktionen H3_INVALID_CELL_ID.

Exempel

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