Funktionen h3_h3tostring
Gäller för: Databricks SQL
Databricks Runtime 11.3 LTS och senare
Konverterar indata-H3-cell-ID:t till motsvarande hexadecimal strängrepresentation.
Syntax
h3_h3tostring ( h3CellIdExpr )
Argument
h3CellIdExpr
: Ett BIGINT-uttryck som representerar ett H3-cell-ID.
Returer
Ett värde av typen STRING. Det returnerade resultatet är big-endian hexadecimal representation av indata BIGINT med inledande nollor borttagna.
Funktionen returnerar NULL om indata är NULL.
Funktionen konverterar BIGINT till motsvarande hexadecimal sträng.
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
h3CellIdExpr
för är mindre än0x08001fffffffffff
eller större än0x08ff3b6db6db6db6
returnerar funktionen H3_INVALID_CELL_ID.
Exempel
-- 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