从补丁 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\$1Dimension
<a name="ST_Dimension-function"></a>

ST\$1Dimension 返回输入几何体的固有维度。*固有维度* 是几何体中定义的子类型的维度值。

对于 3DM、3DZ 和 4D 几何体输入，ST\$1Dimension 返回的结果与 2D 几何体输入的结果相同。

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

```
ST_Dimension(geom)
```

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

 *geom*   
一个 `GEOMETRY` 数据类型的值，或一个计算结果为 `GEOMETRY` 类型的表达式。

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

`INTEGER`，表示 *geom* 的固有维度。

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

返回的值如下所示。


| 返回的值 | 几何体子类型 | 
| --- | --- | 
| 0 | 在 *geom* 为 `POINT` 或 `MULTIPOINT` 子类型时返回 | 
| 1 | 在 *geom* 为 `LINESTRING` 或 `MULTILINESTRING` 子类型时返回。 | 
| 2 | 在 *geom* 为 `POLYGON` 或 `MULTIPOLYGON` 子类型时返回 | 
| 0 | 在 *geom* 为空 `GEOMETRYCOLLECTION` 子类型时返回 | 
| 集合组件的最大维度 | 在 *geom* 为 `GEOMETRYCOLLECTION` 子类型时返回 | 

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

以下 SQL 将四点 LINESTRING 的已知文本 (WKT) 表示形式转换为 GEOMETRY 对象，并返回线串的维度。

```
SELECT ST_Dimension(ST_GeomFromText('LINESTRING(77.29 29.07,77.42 29.26,77.27 29.31,77.29 29.07)'));
```

```
st_dimension
-------------
1
```