h3_isvalid 函数

适用于： Databricks SQL Databricks Runtime 11.3 LTS 及更高版本

如果输入 BIGINT 或 STRING 是有效的 H3 单元 ID，则返回 true。

语法

h3_isvalid ( expr )

参数

• expr：一个 BIGINT 表达式或 STRING 表达式。

返回

BOOLEAN 类型的值，指示输入 BIGINT 或 STRING 是否对应于有效的 H3 单元 ID。

如果输入为 NULL，则该函数返回 NULL。

示例

-- Simple example taking a long as input.
> SELECT h3_isvalid(599686042433355775)
  true

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

-- Example taking a long as input that is not a valid H3 cell ID.
> SELECT h3_isvalid(599686042433355776)
  false

-- Example where the input is an invalid hexadecimal string.
> SELECT h3_isvalid('I am not an H3 cell ID')
  false

相关函数

• h3_ispentagon 函数
• h3_try_validate 函数
• h3_validate 函数