Share via

Fonction h3_boundaryaswkb

  • Article

S’applique à :coche marquée oui Databricks SQL oui coché Databricks Runtime 11.3 LTS et versions ultérieures

Retourne la limite polygonale de la cellule H3 d’entrée au format WKB.

Syntaxe

h3_boundaryaswkb ( h3CellIdExpr )

Arguments

  • h3CellIdExpr : expression BIGINT ou expression STRING hexadécimale représentant un ID de cellule H3.

Retours

Valeur de type BINARY représentant la limite polygonale de la cellule H3 d’entrée au format WKB.

La fonction retourne NULL si l’expression d’entrée est NULL. La fonction effectue une validation partielle pour déterminer si l’argument d’entrée est un ID de cellule H3 valide. Une valeur d’ID H3 comprise entre 0x08001fffffffffff et 0x08ff3b6db6db6db6 constitue une condition nécessaire mais pas suffisante. Le comportement de la fonction n’est pas défini si l’ID de cellule d’entrée ne correspond pas à un ID de cellule valide.

Conditions d'erreur

  • Si h3CellIdExpr correspond à une STRING qui ne peut pas être convertie en BIGINT ou qui correspond à une valeur BIGINT inférieure à 0x08001fffffffffff ou supérieure à 0x08ff3b6db6db6db6, la fonction retourne H3_INVALID_CELL_ID.

Exemples

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