Sdílet prostřednictvím

Funkce h3_h3tostring

  • Č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í ID buňky H3 na ekvivalentní šestnáctkové řetězcové vyjádření.

Syntaxe

h3_h3tostring ( h3CellIdExpr )

Argumenty

  • h3CellIdExpr: Výraz BIGINT představující ID buňky H3.

Návraty

Hodnota typu STRING. Vrácený výsledek je šestnáctková reprezentace vstupu BIGINT s libovolnými počátečními nulami, které jsou vymazané.

Funkce vrátí hodnotu NULL, pokud je vstup NULL. Funkce převede BIGINT na odpovídající šestnáctkový řetězec. 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 je hodnota h3CellIdExpr menší než nebo větší0x08ff3b6db6db6db6, 0x08001fffffffffff vrátí funkce H3_INVALID_CELL_ID.

Příklady

-- Simple example
> SELECT h3_h3tostring(599686042433355775)
  85283473fffffff

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