h3_uncompact函数

适用于:检查标记是的砖的SQL检查标记是的砖运行时11.2及以上

Uncompacts H3细胞的输入设置指定的决议。未压实的集覆盖相同的H3细胞与原始使用细胞在指定的决议。

语法

h3_uncompact(h3CellIdsExpr,resolutionExpr)

参数

  • h3CellIdsExpr:长整型数字表达的一个数组或数组的十六进制字符串表达式代表一个H3细胞id数组。

  • resolutionExpr:一个整数表达式,其值是将输入的最大分辨率H3细胞之间15包容,指定H3细胞IDs的分辨率输出数组。

返回

相同类型的值的数组作为输入数组中的值表达式h3cellIdsExpr。H3细胞IDs的分辨率输出数组的值等于resolutionExpr。

函数返回NULL如果输入为空。函数部分验证关于输入参数是否有效的H3细胞ID,必要但不充分条件之间的有效的H3 ID,它的价值是0 x08001fffffffffff和0 x08ff3b6db6db6db6。函数定义的行为如果任何细胞的ID在输入数组并不是一个有效的细胞ID。NULL值在输入数组将被忽略。

错误条件

  • 如果h3CellIdExpr是一个字符串,不能转换为长整型数字或对应于一个长整型数字值小于0 x08001fffffffffff或比0 x08ff3b6db6db6db6,该函数返回H3_INVALID_CELL_ID。

  • 如果resolutionExpr小于最大分辨率的H3细胞在输入数组,或者比15,该函数返回H3_INVALID_RESOLUTION_VALUE。

例子

——例子输入是一个长整型数字数组>选择h3_uncompact(数组(599686030622195711,599686015589810175,599686014516068351,599686034917163007,599686029548453887,599686032769679359,599686198125920255,599686023106002943,599686027400970239,599686013442326527,599686012368584703,599686018811035647,595182446027210751),5);(599686030622195711,599686015589810175,599686014516068351,599686034917163007,599686029548453887,599686032769679359,599686198125920255,599686023106002943,599686027400970239,599686013442326527,599686012368584703,599686018811035647,599686038138388479,599686039212130303,599686040285872127,599686041359613951,599686042433355775,599686043507097599,599686044580839423]——在这个例子中,我们验证uncompacting压实的H3的双环细胞在细胞的决议返回原来的双环。>选择数(*)从((选择爆炸(h3_uncompact(h3_compact(h3_kring(599686042433355775,2)),h3_resolution(599686042433355775))))-(选择爆炸(h3_kring(599686042433355775,2))))0——第二个输入一个无效的分辨率值。>选择h3_uncompact(数组(599686030622195711,599686015589810175,599686014516068351,599686034917163007,599686029548453887,599686032769679359,599686198125920255,599686023106002943,599686027400970239,599686013442326527,599686012368584703,599686018811035647,595182446027210751),2);(H3_INVALID_RESOLUTION_VALUE]H3决议2必须是之间的5和15,包容