Condividi tramite

Funzione h3_boundaryaswkb

  • Articolo

Si applica a: segno di spunta sì Databricks SQL segno di spunta sì Databricks Runtime 11.3 LTS e versioni successive

Restituisce il limite poligonale della cella H3 di input in formato WKB .

Sintassi

h3_boundaryaswkb ( h3CellIdExpr )

Argomenti

  • h3CellIdExpr: espressione BIGINT o espressione STRING esadecimale che rappresenta un ID cella H3.

Valori restituiti

Valore del tipo BINARY che rappresenta il limite poligonale della cella H3 di input in formato WKB .

La funzione restituisce NULL se l'espressione di input è NULL. La funzione esegue la convalida parziale relativa al fatto che l'argomento di input sia un ID cella H3 valido. Una condizione necessaria, ma non sufficiente per un ID H3 valido è che il relativo valore è compreso tra 0x08001fffffffffff e 0x08ff3b6db6db6db6. Il comportamento della funzione non è definito se l'ID cella di input non è un ID cella valido.

Condizioni di errore

  • Se h3CellIdExpr è un valore STRING che non può essere convertito in bigint o corrisponde a un valore BIGINT minore o maggiore di 0x08001fffffffffff 0x08ff3b6db6db6db6, la funzione restituisce H3_INVALID_CELL_ID.

Esempi

-- Input a BIGINT representing a hexagonal cell.
> SELECT hex(h3_boundaryaswkb(599686042433355775))
  01030000000100000007000000E27B13AD907A5EC08998FEC9BBA24240300C97AA2E775EC0A2CC41764DAD4240159571711B7B5EC0DCE64CE2D3B64240255DE93F6A825EC08F5EC9C6C6B54240B4356B96C9855EC0546EAB0935AB42407ACFBCCBDC815EC0CBADA278B0A14240E27B13AD907A5EC08998FEC9BBA24240

-- Input a STRING representing a pentagonal cell.
> SELECT hex(h3_boundaryaswkb('8009fffffffffff'))
  01030000000100000006000000418DC418D4E324C0212965BB2A8C4F40DA750FCD3618164003D6996377DA4B4022DC574A2D153940770583D265334D4098617DCCCED43F40BE65106E843B5140677635CDCCD6D43F4DDB71B4DA535240418DC418D4E324C0212965BB2A8C4F40

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