

 Amazon Redshift は、パッチ 198 以降、新しい 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 は、次のように、入力ジオメトリの最小の境界ボックスを返します。
+ 入力ジオメトリが空の場合、返されるジオメトリは入力ジオメトリのコピーです。
+ 入力ジオメトリの最小の境界ボックスに含まれるのが 1 つのポイントのみの場合、返されるジオメトリは 1 つのポイントです。
+ 入力ジオメトリの最小の境界ボックスが 1 次元である場合、2 つのポイントのラインストリングが返されます。
+ 上記のいずれにも該当しない場合、この関数は、その頂点を最小の境界ボックスの角とする時計回りのポリゴンを返します。

返されるジオメトリの空間参照系識別子 (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` オブジェクトの 4 つのポイントを持つ `GEOMETRY` の WKT (Well-known text) 表現を変換し、その頂点を最小の境界ボックスの角とするポリゴンを返します。

```
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))
```