h3_maxchild函數

返回輸入H3單元格在指定分辨率下的最大值的子單元。

適用於:勾選“是”Databricks SQL預覽勾選“是”Databricks運行時11.3及以上版本

語法

h3_maxchild（h3cellIdExpr，resolutionExpr）

參數

  • h3CellIdExpr: BIGINT表達式，或表示H3單元格ID的十六進製STRING表達式。

  • resolutionExpr: INT型表達式，它的值應該在between之間h3_resolution (h3CellIdExpr)而且15包含，指定子H3單元格ID的分辨率。

返回

類的類型相同類型的值h3CellIdExpr表達式，對應於輸入H3單元ID在指定分辨率下的最大值的子單元。

如果兩個輸入表達式中的任何一個為NULL，則該函數返回NULL。該函數對輸入參數是否為有效的H3單元格ID進行部分驗證。一個有效H3 ID的必要但不是充分條件是它的值在0 x08001fffffffffff而且0 x08ff3b6db6db6db6．如果輸入單元格ID不是有效的單元格ID，則函數的行為是未定義的。的值resolutionExpr等於輸入H3單元格ID的分辨率，則返回輸入H3單元格ID。

錯誤條件

  • 如果h3CellIdExpr是一個不能轉換為BIGINT或對應的BIGINT值小於0 x08001fffffffffff或者大於0 x08ff3b6db6db6db6，函數返回H3_INVALID_CELL_ID．

  • 如果resolutionExpr小於h3_resolution (h3CellIdExpr)或者大於15，函數返回H3_INVALID_RESOLUTION_VALUE．

例子

簡單的例子，輸入一個長。>選擇h3_maxchild（599686042433355775，10）622204040416821247簡單的例子，以一個有效的十六進製字符串作為輸入。>選擇h3_maxchild（“85283473 fffffff”，10）8a2834736db7fff——第一個輸入是無效的H3單元ID。>選擇h3_maxchild（0，15）［H3_INVALID_CELL_ID]0是不一個有效的H3細胞ID——第二個輸入是無效的分辨率值。>選擇h3_maxchild（“85283473 fffffff”，4）［H3_INVALID_RESOLUTION_VALUE]H3決議4必須是之間的5而且15，包容