

 从补丁 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/)。

# ST\$1Z
<a name="ST_Z-function"></a>

ST\$1Z 返回输入点的 `z` 坐标。

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

```
ST_Z(point)
```

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

 *point*   
一个 `POINT` 数据类型的 `GEOMETRY` 值。

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

`m` 坐标的 `DOUBLE PRECISION` 值。

如果 *point* 为 null，则返回 null。

如果 *point* 是 2D 或 3DM 点，则返回 null。

如果 *point* 是空点，则返回 null。

如果 *point* 不是 `POINT`，则返回一个错误。

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

以下 SQL 返回 3DZ 几何体中一个点的 `z` 坐标。

```
SELECT ST_Z(ST_GeomFromEWKT('POINT Z (1 2 3)'));
```

```
st_z
-----------
 3
```

以下 SQL 返回 4D 几何体中一个点的 `z` 坐标。

```
SELECT ST_Z(ST_GeomFromEWKT('POINT ZM (1 2 3 4)'));
```

```
st_z
-----------
 3
```