h3_stringtoh3函數

適用於:檢查標記是的磚的SQL檢查標記是的磚運行時11.2及以上

,預計將輸入字符串轉換成十六進製字符串代表一個H3細胞,到相應的H3的BIGINT表示細胞。

語法

h3_stringtoh3(h3CellIdExpr)

參數

  • h3CellIdStringExpr:一個格式良好的十六進製字符串表達式代表一個有效的H3細胞ID。

返回

長整型數字類型的值。的返回值是長整型數字表示輸入十六進製字符串。

函數返回NULL如果輸入為空。將十六進製字符串轉換為相應的長整型數字號碼。函數部分驗證關於輸入參數是否有效的H3細胞ID,必要但不充分條件之間的有效的H3 ID,它的價值是0 x08001fffffffffff和0 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