h3_minchild函數

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

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

語法

h3_minchildh3cellIdExprresolutionExpr

參數

  • 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_minchild59968604243335577510622204039496499199簡單的例子,以一個有效的十六進製字符串作為輸入。>選擇h3_minchild“85283473 fffffff”108a2834700007fff——第一個輸入是無效的H3單元ID。>選擇h3_minchild015H3_INVALID_CELL_ID0一個有效的H3細胞ID——第二個輸入是無效的分辨率值。>選擇h3_minchild“85283473 fffffff”4H3_INVALID_RESOLUTION_VALUEH3決議4必須之間的5而且15包容