View a markdown version of this page

ST_MakeEnvelope - Amazon Redshift

Amazon Redshift 將不再支援在 2026 年 6 月 30 日之後使用 Python UDFs。我們將開始分階段強制執行。如需 Python 生命週期結束和遷移選項的詳細資訊,請參閱 2025 年 6 月 30 日發佈的部落格文章。

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

ST_MakeEnvelope

ST_MakeEnvelope 會傳回幾何,如下所示:

  • 如果輸入座標指定了一個點,則傳回的幾何為一個點。

  • 如果輸入座標指定了直線,則傳回的幾何為 linestring。

  • 否則,傳回的幾何為多邊形,其中輸入座標會指定方塊的左下角和右上角。

如果提供,則傳回幾何的空間參考系統識別碼 (SRID) 值將設定為輸入 SRID 值。

語法

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

引數

xmin

DOUBLE PRECISION 資料類型的值。此值是方塊左下角的第一個座標。

ymin

DOUBLE PRECISION 資料類型的值。此值是方塊左下角的第二個座標。

xmax

DOUBLE PRECISION 資料類型的值。此值為方塊右上角的第一個座標。

ymax

DOUBLE PRECISION 資料類型的值。此值為方塊的右上角的第二個座標。

srid

INTEGER 資料類型的值,表示空間參考系統識別碼 (SRID)。如果未提供 SRID 值,則會將其設定為零。

傳回類型

POINT、LINESTRING 或 POLYGON 子類型的 GEOMETRY。

如果未設定 srid,則傳回幾何的 SRID 會設定為 srid 或零。

如果 xmin、ymin、xmax、ymax 或 srid 為 null,則傳回 null。

如果 srid 為負值,則會傳回錯誤。

範例

下列 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))