从补丁 198 开始，Amazon Redshift 将不再支持创建新的 Python UDF。现有的 Python UDF 将继续正常运行至 2026 年 6 月 30 日。有关更多信息，请参阅[博客文章](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/)。

# H3\$1IsValid
<a name="H3_IsValid-function"></a>

如果输入表示 H3 单元格 ID，则 H3\$1IsValid 返回 true，否则返回 false。有关 H3 索引的信息，请参阅[H3](spatial-terminology.md#spatial-terminology-h3)。

## 语法
<a name="H3_IsValid-function-syntax"></a>

```
H3_IsValid(index)
```

## 参数
<a name="H3_IsValid-function-arguments"></a>

 * 索引*   
一个 `BIGINT` 或 `VARCHAR` 数据类型的值，或一个计算结果为这两种数据类型之一的表达式。

## 返回类型
<a name="H3_IsValid-function-return"></a>

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

如果 *index* 为 NULL，则返回 NULL。

## 示例
<a name="H3_IsValid-function-examples"></a>

以下 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
```