h3_stringtoh3函数

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

,预计将输入字符串转换成十六进制字符串代表一个H3细胞,到相应的H3的BIGINT表示细胞。

语法

h3_stringtoh3(h3CellIdExpr)

参数

  • h3CellIdStringExpr:一个格式良好的十六进制字符串表达式代表一个有效的H3细胞ID。

返回

长整型数字类型的值。的返回值是长整型数字表示输入十六进制字符串。

函数返回NULL如果输入为空。将十六进制字符串转换为相应的长整型数字号码。函数部分验证关于输入参数是否有效的H3细胞ID,必要但不充分条件之间的有效的H3 ID,它的价值是0 x08001fffffffffff0 x08ff3b6db6db6db6。函数定义的行为如果输入细胞ID不是一个有效的ID。

错误条件

  • 如果该值的h3CellIdStringExpr不能转换为长整型数字或者值对应于一个长整型数字值,小于0 x08001fffffffffff或比0 x08ff3b6db6db6db6,该函数返回H3_INVALID_CELL_ID

例子

——简单的例子>选择h3_stringtoh3(“85283473 fffffff”)599686042433355775——输入一个无效的H3细胞ID。>选择h3_stringtoh3(' 0 ')(H3_INVALID_CELL_ID]0一个有效的H3细胞ID