h3_toparent函數

適用於:勾選“是”磚的SQL勾選“是”Databricks運行時11.2及以上

以指定的分辨率返回輸入H3單元格的父H3單元格。

語法

h3_toparent（h3cellIdExpr，resolutionExpr）

參數

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

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

返回

類的類型相同類型的值h3CellIdExpr表達式，對應於輸入H3單元在指定分辨率下的父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小於0或者大於h3_resolution (h3CellIdExpr)，函數返回H3_INVALID_RESOLUTION_VALUE．

例子

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