Sdílet prostřednictvím

Funkce h3_stringtoh3

  • Č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šší

Převede vstupní řetězec, který má být šestnáctkovým řetězcem představujícím buňku H3, na odpovídající reprezentaci buňky H3 BIGINT.

Syntaxe

h3_stringtoh3 ( h3CellIdExpr )

Argumenty

  • h3CellIdStringExpr: Hexadecimální výraz STRING ve správném formátu představující platné ID buňky H3.

Návraty

Hodnota typu BIGINT. Vrácená hodnota je reprezentace BIGINT vstupního šestnáctkového řetězce.

Funkce vrátí hodnotu NULL, pokud je vstup NULL. Funkce převede šestnáctkový řetězec na odpovídající číslo BIGINT. Funkce provádí částečné ověření týkající se toho, jestli je vstupním argumentem platné 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 id vstupní buňky není platné ID buňky.

Chybové podmínky

  • Pokud hodnotu h3CellIdStringExpr nelze převést na BIGINT nebo pokud hodnota odpovídá hodnotě BIGINT, která je menší nebo větší než 0x08001fffffffffff 0x08ff3b6db6db6db6, vrátí funkce H3_INVALID_CELL_ID.

Příklady

-- Simple example
> SELECT h3_stringtoh3('85283473fffffff')
  599686042433355775

-- Input is an invalid H3 cell ID.
> SELECT h3_stringtoh3('0')
  [H3_INVALID_CELL_ID] 0 is not a valid H3 cell ID