

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

ST\$1Envelope 返回输入几何体的最小边界框，如下所示：
+ 如果输入几何体为空，则返回的几何体是输入几何体的副本。
+ 如果输入几何体的最小边界框退化为一个点，则返回的几何体是一个点。
+ 如果输入几何体的最小边界框是一维的，则返回两点线串。
+ 如果上述条件都不成立，则函数将返回一个顺时针方向的多边形，其顶点为最小边界框的角。

返回的几何体的空间参考系统标识符 (SRID) 与输入几何体的相同。

对于所有非空输入，该函数在输入几何体的 2D 投影上运行。

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

```
ST_Envelope(geom)
```

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

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

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

`GEOMETRY` 

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

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

以下 SQL 将四点 `LINESTRING` 的已知文本 (WKT) 表示形式转换为 `GEOMETRY` 对象，并返回其顶点为最小边界框的角的多边形。

```
SELECT ST_AsText(ST_Envelope(ST_GeomFromText('GEOMETRYCOLLECTION(POLYGON((0 0,10 0,0 10,0 0)),LINESTRING(20 10,20 0,10 0))')));
```

```
    st_astext
------------------------------------
  POLYGON((0 0,0 10,20 10,20 0,0 0))
```