H3_IsValid - Amazon Redshift

从 2025 年 11 月 1 日起,Amazon Redshift 将不再支持创建新的 Python UDF。如果您想要使用 Python UDF,请在该日期之前创建 UDF。现有的 Python UDF 将继续正常运行。有关更多信息,请参阅博客文章

H3_IsValid

如果输入表示 H3 单元格 ID,则 H3_IsValid 返回 true,否则返回 false。有关 H3 索引的信息,请参阅H3

语法

H3_IsValid(index)

参数

索引

一个 BIGINTVARCHAR 数据类型的值,或一个计算结果为这两种数据类型之一的表达式。

返回类型

BOOLEAN:如果输入表示有效的 H3 单元格 ID,则为 true,否则为 false。

如果 index 为 NULL,则返回 NULL。

示例

以下 SQL 输入一个表示 H3 单元格 ID 的 VARCHAR,并返回 true。

SELECT H3_IsValid('8025fffffffffff');
h3_isvalid ------------ true

以下 SQL 输入一个表示 H3 单元格 ID 的 BIGINT,并返回 true。

SELECT H3_IsValid(577129255373111295);
h3_isvalid ------------ true

以下 SQL 输入一个无效的 H3 单元格 ID,并返回 false。

SELECT H3_IsValid('');
h3_isvalid ------------ false