

 Amazon Redshift 將不再支援從修補程式 198 開始建立新的 Python UDFs。現有 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\$1Enelope 會傳回輸入幾何的最小週框方塊，如下所示。
+ 如果輸入幾何為空白，則傳回的幾何為輸入幾何的副本。
+ 如果輸入幾何圖形的最小週框方塊退化為一點，則傳回的幾何為一點。
+ 如果輸入幾何的最小週框方塊為一維，則會傳回兩點 linestring。
+ 如果上述情況都不成立，則函數會傳回順時針方向的多邊形，其頂點是最小週框方塊的邊角。

所傳回幾何的空間參考系統識別碼 (SRID) 與輸入幾何的 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))
```