

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

ST\$1MakeEnvelope 返回一个几何体，如下所示：
+ 如果输入坐标指定一个点，则返回的几何体是一个点。
+ 如果输入坐标指定一条线，则返回的几何为线串。
+ 否则，返回的几何体位面，其中输入坐标指定框的左下角和右上角。

返回的几何体的空间参考系统标识符 (SRID) 值（如有提供）将设置为输入 SRID 值。

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

```
ST_MakeEnvelope(xmin, ymin, xmax, ymax)
```

```
ST_MakeEnvelope(xmin, ymin, xmax, ymax, srid)
```

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

 *xmin*   
一个 数据类型的 值`DOUBLE PRECISION` 此值是框左下角的第一个坐标。

 *ymin*   
一个 数据类型的 值`DOUBLE PRECISION` 此值是框左下角的第二个坐标。

 *xmax*   
一个 数据类型的 值`DOUBLE PRECISION` 此值是框右上角的第一个坐标。

 *ymax*   
一个 数据类型的 值`DOUBLE PRECISION` 此值是框右上角的第二个坐标。

 *srid*   
数据类型 `INTEGER` 的一个值，它表示空间参考系统标识符 (SRID)。如果未提供 SRID 值，则它会设置为零。

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

子类型 `POINT`、`LINESTRING` 或 `POLYGON` 的 `GEOMETRY`。

返回的几何体的 SRID 将设置为 `srid`，如果未设置 `srid`，则设置为零。

如果 *xmin*、*ymin*、*xmax*、*ymax* 或 *srid* 为 null，则返回 null。

如果 *srid* 为负，则返回一个错误。

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

以下 SQL 会返回一个面，表示由四个输入坐标值定义的信封。

```
SELECT ST_AsEWKT(ST_MakeEnvelope(2,4,5,7));
```

```
 st_astext
---------------
 POLYGON((2 4,2 7,5 7,5 4,2 4))
```

以下 SQL 会返回一个面，表示由四个输入坐标值和一个 SRID 值定义的信封。

```
SELECT ST_AsEWKT(ST_MakeEnvelope(2,4,5,7,4326));
```

```
 st_astext
----------------------------------
 SRID=4326;POLYGON((2 4,2 7,5 7,5 4,2 4))
```