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\$1GeomFromText
<a name="ST_GeomFromText-function"></a>

ST\$1GeomFromText 會從輸入幾何的已知文字 (WKT) 表示法建構幾何物件。

ST\$1GeomFromText 接受 3DZ、3DM 和 4D，其中幾何類型的前綴分別為 Z、M 或 ZM。

## 語法
<a name="ST_GeomFromText-function-syntax"></a>

```
ST_GeomFromText(wkt_string)
```

```
ST_GeomFromText(wkt_string, srid)
```

## 引數
<a name="ST_GeomFromText-function-arguments"></a>

 *wkt\$1string*   
`VARCHAR` 資料類型的值，其為幾何的 WKT 表示法。  
您可以使用 WKT 關鍵字 `EMPTY` 來指定空點、具有空點的多點或具有空點的幾何集合。下列範例使用一個空點和一個非空點建立多點。  

```
ST_GeomFromEWKT('MULTIPOINT(1 0,EMPTY)');
```

 *srid*   
`INTEGER` 資料類型的值，其為空間參考識別碼 (SRID)。如果有提供 SRID 值，則傳回的幾何便會包含此 SRID 值。否則，傳回幾何的 SRID 值會設為零 (0)。

## 傳回類型
<a name="ST_GeomFromText-function-return"></a>

`GEOMETRY`

如果 *wkt\$1string* 或 *srid* 為 Null，則會傳回 Null。

如果 *srid* 為負值，則會傳回 Null。

如果 *wkt\$1string* 無效，則會傳回錯誤。

如果 *srid* 無效，則會傳回錯誤。

## 範例
<a name="ST_GeomFromText-function-examples"></a>

以下 SQL 會從 WKT 表示法和 SRID 值建構幾何物件。

```
SELECT ST_GeomFromText('POLYGON((0 0,0 1,1 1,1 0,0 0))',4326);
```

```
st_geomfromtext
--------------------------------
0103000020E61000000100000005000000000000000000000000000000000000000000000000000000000000000000F03F000000000000F03F000000000000F03F000000000000F03F000000000000000000000000000000000000000000000000
```