Funktionen h3_stringtoh3

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

Konverterar indatasträngen, som förväntas vara en hexadecimal sträng som representerar en H3-cell, till motsvarande BIGINT-representation av H3-cellen.

Syntax

h3_stringtoh3 ( h3CellIdExpr )

Argument

• h3CellIdStringExpr: Ett välformat hexadecimalt STRING-uttryck som representerar ett giltigt H3-cell-ID.

Returer

Ett värde av typen BIGINT. Det returnerade värdet är BIGINT-representationen av den hexadecimala indatasträngen.

Funktionen returnerar NULL om indata är NULL. Funktionen konverterar hexadecimal strängen till motsvarande BIGINT-tal. Funktionen validerar delvis om indataargumentet ä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 indatacells-ID:t inte är ett giltigt cell-ID.

Feltillstånd

• Om värdet h3CellIdStringExpr för inte kan konverteras till en BIGINT eller om värdet motsvarar ett BIGINT-värde som är mindre än eller större än 0x08001fffffffffff 0x08ff3b6db6db6db6returnerar funktionen H3_INVALID_CELL_ID.

Exempel

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

Relaterade funktioner

• funktionen h3_h3tostring