h3_minchild
函數
返回輸入H3單元格在指定分辨率下的最小值的子單元。
適用於:Databricks SQL預覽Databricks運行時11.3及以上版本
參數
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_minchild(599686042433355775,10)622204039496499199簡單的例子,以一個有效的十六進製字符串作為輸入。>選擇h3_minchild(“85283473 fffffff”,10)8a2834700007fff——第一個輸入是無效的H3單元ID。>選擇h3_minchild(0,15)[H3_INVALID_CELL_ID]0是不一個有效的H3細胞ID——第二個輸入是無效的分辨率值。>選擇h3_minchild(“85283473 fffffff”,4)[H3_INVALID_RESOLUTION_VALUE]H3決議4必須是之間的5而且15,包容