Sdílet prostřednictvím

Funkce h3_ischildof

  • Článek

Platí pro: zaškrtnutí označeného ano Databricks SQL zaškrtnutí označeného ano Databricks Runtime 11.3 LTS a vyšší

Vrátí hodnotu true, pokud je první buňka H3 stejná jako druhá buňka H3 nebo podřízená buňka H3.

Syntaxe

h3_ischildof ( h3CellId1Expr, h3cellId2Expr )

Argumenty

  • h3CellId1Expr: Výraz BIGINT nebo šestnáctkový výraz STRING představující ID buňky H3.
  • h3CellId2Expr: Výraz BIGINT nebo šestnáctkový výraz STRING představující ID buňky H3.

Návraty

Hodnota typu BOOLEAN označující, jestli první buňka H3 odpovídá druhé buňce H3 nebo podřízené buňce H3.

Funkce vrátí hodnotu NULL, pokud některý ze vstupů je NULL. Funkce provádí částečné ověření týkající se toho, zda některý ze dvou vstupních argumentů je platným ID buňky H3. Nezbytným, ale ne dostatečným předpokladem platného ID H3 je, že jeho hodnota je mezi 0x08001fffffffffff a 0x08ff3b6db6db6db6. Chování funkce není definováno, pokud některé ze dvou ID vstupních buněk není platné ID buňky.

Chybové podmínky

  • Pokud h3CellId1Expr nebo h3CellId2Expr je řetězec, který nelze převést na BIGINT nebo odpovídá hodnotě BIGINT, která je menší nebo větší než 0x08001fffffffffff 0x08ff3b6db6db6db6, vrátí funkce H3_INVALID_CELL_ID.

Příklady

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