h3_isvalid function

适用于:勾选为是 Databricks SQL 勾选为是 Databricks 运行时间 11.3 LTS 及以上 勾选为是 Lakehouse//RT

如果输入 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