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

對於線性幾何，ST\$1Length 傳回 2D 投影的笛卡爾長度。長度單位與表示輸入幾何座標的單位相同。對於點、multipoint 和面積幾何，此函數會傳回零 (0)。當輸入為幾何集合時，此函數會傳回集合中幾何的長度總和。

對於地理，ST\$1Length 會傳回在球體 (由 SRID 決定) 上所計算輸入線性地理之 2D 投影的測地線長度。長度的單位是公尺。對於點、multipoint 和面積地理，此函數會傳回零 (0)。當輸入為幾何集合時，此函數會傳回集合中地理的長度總和。

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

```
ST_Length(geo)
```

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

 *geo*   
`GEOMETRY` 或 `GEOGRAPHY` 資料類型的值，或是評估為 `GEOMETRY` 或 `GEOGRAPHY` 類型的運算式。

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

`DOUBLE PRECISION`

如果 *geo* 為 null，則傳回 null。

如果找不到 SRID 值，則會傳回錯誤。

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

下列 SQL 會傳回 multilinestring 的笛卡爾長度。

```
SELECT ST_Length(ST_GeomFromText('MULTILINESTRING((0 0,10 0,0 10),(10 0,20 0,20 10))'));
```

```
st_length
--------------------------------
  44.142135623731
```

以下 SQL 會傳回幾何中 linestring 的長度。

```
SELECT ST_Length(ST_GeogFromText('SRID=4326;LINESTRING(5 0,6 0,4 0)'));
```

```
 st_length 
------------------
 333958.472379804
```

下列 SQL 會傳回地理中某個點的長度。

```
SELECT ST_Length(ST_GeogFromText('SRID=4326;POINT(4 5)'));
```

```
 st_length 
-----------
 0
```