h3_try_validate函式

適用於： Databricks SQL Databricks Runtime 11.3 LTS 和更新版本

如果輸入值對應至有效的 H3 單元格，則傳回 BIGINT 或 STRING 類型的輸入值，否則傳回 NULL。 在 STRING 輸入的情況下，會修剪任何前置零。

語法

h3_try_validate ( h3CellIdExpr )

引數

• h3CellIdExpr：BIGINT 運算式，或預期代表有效 H3 單元格標識碼的 STRING 表達式。

傳回

與表達式類型 h3CellIdExpr 相同的值，且等於輸入 h3CellIdExpr 表達式的值，或 NULL。 在 STRING 輸入的情況下，會修剪任何前置零。

如果輸入為 NULL，函式會傳回 NULL。 函式可以針對非 NULL 輸入傳回 NULL。

範例

-- Simple example taking a long as input.
> SELECT h3_try_validate(590112357393367039)
  590112357393367039

-- Simple example taking a hexadecimal string as input.
> SELECT h3_try_validate('85283473fffffff')
  85283473fffffff

-- Simple taking a long as input, that is not a valid H3 cell ID.
> SELECT h3_try_validate(599686042433355776)
  null

相關函數

• h3_isvalid函式
• h3_validate函式