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

線形ジオメトリの場合、ST\$1Length は 2D 射影のデカルト座標系での長さを返します。長さの単位は、入力ジオメトリの座標を表す単位と同じです。この関数は、ポイント、マルチポイント、および面積ジオメトリに対して 0 を返します。入力がジオメトリコレクションの場合、この関数はコレクションのジオメトリの長さの合計を返します。

ジオグラフィに対して ST\$1Length は、SRID で決定される回転楕円体上で計算され与えられた、線形ジオグラフィの 2D 射影について測地座標系での長さが返します。長さの単位はメートルです。この関数は、ポイント、マルチポイント、および面積ジオグラフィに対して 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は、マルチラインストリングのデカルト座標系での長さを返します。

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

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

次の SQL は、ジオグラフィ内にあるライン文字列の長さを返します。

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